Collection of Tools & Utilities

home *** CD-ROM | disk | FTP | other *** search

/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / sbbs_116.zip / DOCS.ZIP / SDOC116A.ASC next >

Wrap

Text File | 1992-05-06 | 265KB | 5,976 lines

│ │ │ ▄▄▄▄ │ ▄ ▀ │ SuperBBS Bulletin Board Software. ▀▀▀▄ │ ▀▄▄▄▀ │ Release 1.16, date: May 6, 1992 │ ▄ ▄ │ Copyright (C) 1990-1992 █ █ │ █ █ │ █▄▄▄▀ │ │ SuperBBS program and utilities are copyrighted by: ▄▄▄▄ │ ▄ █ │ - Risto Virkkala █▀▀▀ │ - Aki Antman █ │ │ Some external utilities based upon code written by: ▄▄▄▄ │ ▄ │ - Jouni Malinen █▀▀ │ █▄▄▄ │ Documentation is copyrighted by: │ ▄▄▄▄ │ - Frank Hemmelder ▄ █ │ █▀█▀ │ █ ▀▄ │ │ ▄▄▄▄ │ Documentation release V1.16FH01. ▄ █ │ █▀▀▀▄ │ █▄▄▄▀ │ │ ▄▄▄▄ │ SuperBBS, the specific external utilities and this ▄ █ │ documentation are protected under the copyright laws █▀▀▀▄ │ of Finland and other countries. You are not authorized █▄▄▄▀ │ to copy, edit or modify these files without written │ permission of the copyright holders. ▄▄▄▄ │ ▄ ▀ │ ▀▀▀▄ │ All none SuperBBS programs mentioned in this ▀▄▄▄▀ │ documentation are owned by their respectie owners. │ All programs are (C)opyrighted. │ │ │ │ This documentation is for release 1.16 of SuperBBS. │ Woerden, Holland, May 6, 1992 │ Index ============================================================== Part A: -------------------------------------------------------------- 1.0 SuperBBS general information 001 1.1 General information 001 1.2 SuperBBS credits 002 1.3 SuperBBS addresses 002 1.4 How to contact us 003 1.5 Legal stuff 004 1.6 How to register 005 1.6.1 Registration in Finland only 005 1.6.2 Registration abroad 005 1.6.3 Site registration 006 1.7 Differences evaluation/registration 006 1.8 Distribution files 007 2.0 Installation 008 2.1 General information 008 2.2 Software requirements 008 2.3 Hardware requirements 009 2.4 Unpacking the software 009 2.5 Configuring SuperBBS 010 2.5.1 ? 011 2.5.2 Registration 012 2.5.2.1 Information 012 2.5.2.2 Registration 012 2.5.3 Messages 013 2.5.3.1 Message areas 013 2.5.3.2 Global options 018 2.5.3.3 Netmail 022 2.5.3.4 QWK setup 023 2.5.4 Files 025 2.5.4.1 File areas 025 2.5.4.2 Global options 027 2.5.4.3 Internal protocols 031 2.5.4.4 External protocols 032 2.5.5 Modem 036 2.5.5.1 Initialization 036 2.5.5.2 General options 037 2.5.6 Other 037 2.5.6.1 New users 038 2.5.6.2 General options 041 2.5.6.3 On/Off settings 045 2.5.6.4 Restrictions 050 2.5.6.5 Alt-F keys 051 2.5.6.6 String configuration 052 2.5.6.7 Door configuration 054 2.5.6.8 Multi node configuration 056 2.5.6.9 Event editor 056 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page i 2.5.6.10 Keyboard password 058 2.5.7 Colours 058 2.5.8 Limits 059 2.5.9 Paths 061 2.5.10 Quit 064 2.6 Environment variable 064 3.0 Language support 065 3.1 General information 065 3.2 Lconfig.exe 065 3.2.1 Path & description 066 3.2.2 Logon strings (Page 1) 068 3.2.3 Logon strings (Page 2) 070 3.2.4 Message base strings (Page 1) 071 3.2.5 Message base strings (Page 2) 073 3.2.6 Message base strings (Page 3) 075 3.2.7 Message reading command keys 076 3.2.8 File area strings (Page 1) 078 3.2.9 File area strings (Page 2) 080 3.2.10 File area strings (Page 3) 083 3.2.11 Other strings (Page 1) 083 3.2.12 Other strings (Page 2) 085 3.2.13 Other strings (Page 3) 087 3.2.14 Other strings (Page 4) 090 3.2.15 Status string configuration 090 3.2.16 Month names 092 3.2.17 Weekday names 092 3.2.18 BBS list strings 092 3.2.19 Multi line status strings 093 3.2.20 QWK strings 094 3.2.21 A little help 096 3.3 Control codes in strings 096 3.4 Language.ctl file 097 3.5 Hints and tips 098 Part B: ----------------------------------------------------------- 4.0 Converting from other software 099 4.1 General information 099 4.2 Converting from QBBS, RA, Proboard 099 4.3 Converting from other software 099 5.0 Menus 100 5.1 General information 100 5.2 Menu commands 102 5.3 Menu templating 125 5.4 Changing hardcoded menu options 127 5.5 Include1.mnu 128 6.0 Control codes 129 6.1 Control codes in menu and textfiles 129 6.2 ^F codes 129 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page ii 6.3 ^K codes 130 6.4 ^X, ^C, ^P and ^A keys 131 6.5 ^O control codes 132 6.6 Additional codes 132 7.0 Message base 134 7.1 General information 134 7.2 Sysop keys available 135 7.3 QWK offline mail system 136 7.4 Group messages 137 7.5 Netmail 137 7.6 Echomail 138 7.7 Nodelist support 139 7.8 Search userlist 139 8.0 Files base 140 8.1 General information 140 8.2 Extract and view option 140 8.3 Uploader to files.bbs 141 8.4 Files.ctl 141 8.5 File flagging & Archive view 142 8.6 Download counter 143 8.7 Default protocol 143 9.0 Support files 144 9.1 General information 144 9.2 ANSI and ASCII support files 144 9.3 .CTL, .LNG and .BBS support files 150 10.0 Questionnaire language 157 10.1 General information 157 10.2 Available commands 157 10.3 Newuser.q-a & Expired.q-a 160 10.4 Questionnaire example 161 11.0 Running SuperBBS 163 11.1 General information 163 11.2 Command line options 163 11.3 Online Sysop keys 165 11.4 User's online keys 167 11.5 Errorlevels 168 11.6 Yell and chat 168 11.7 Alias system 169 11.8 View a certain file 170 11.9 Menu to run 170 11.10 Expiration system 170 12.0 Multitasking and multiline 171 12.1 General information 171 12.2 Multiline configuration 171 12.3 Multitaskers & networks 173 12.4 Message base locking 173 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page iii 13.0 External specific SuperBBS utilities 174 13.1 General information 174 13.2 Userpack.exe 174 13.3 Sbbsuser.exe 175 13.4 Sbbsutil.exe 176 13.5 Usersort.exe 177 13.6 Sbbsmenu.exe 178 13.6.1 File commands 179 13.6.2 Text commands 180 13.6.3 Menu commands 180 13.6.4 Prompt 181 13.6.5 Setup 181 13.7 Sbbsnode.exe 181 13.8 Snetmgr.exe 182 13.8.1 Users online 182 13.8.2 Last callers 182 13.9 Board2cf.exe 182 14.0 Usefull information 183 14.1 Batchfiles 183 14.2 Equipment 187 14.3 Turbo pascal errors 187 14.4 Credits 189 15.0 Supernet 190 Appendix A Menu list 192 Appendix B Bugreport & suggestion form 194 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page iv Chapter 1. SuperBBS general information ============================================================== 1.1 General information -------------------------------------------------------------- Welcome to this release of SuperBBS. Please read the documen- tation carefully to get informed about all new options of the SuperBBS program or the changes in the already available options. SuperBBS is a QuickBBS (TM) look alike software program, but with many different options. It uses the Hudson type message base, meaning that you have only 5 files, which contains your complete messagebase. Menu and textfiles options are very flexible and a Sysop can build his BBS system as complex as he/she wants. Many doors (= external programs like utilities and games) are available for use in SuperBBS. SuperBBS is distributed as Shareware. This means you can test the software for 30 days, before you either have to register or to stop using the program. Not registering the program but using the program after 30 days could mean that a next version of SuperBBS will not be distributed as Shareware. Please support Shareware and register your software after the trail period. SuperBBS, it's specific external utilities and the documenta- tion are protected under the copyright laws of Finland and other countries. You are not allowed to modify, edit, change, loan etc. these files without written permission of the copyright holders. Any violation of this copyright will be reported to the authorities. This includes patching an un- registered version of SuperBBS to make it appear registered. An international Fidonet echomail link called SUPERBBS has been set up and is available to most countries. If you have problems, questions or remarks about SuperBBS and it's util- ities, please search for this area on a BBS near you. Most SuperBBS sites have this echo available. There is also a SuperBBS SDS area available. Available to all SuperBBS sysops, registered or unregistered, is the network SuperNet. This is an international fido like network for SuperBBS sysops all over the world. It has it's own echomail areas available for reporting bugs, finding hints and other useful information. Supernet is available to regis- tered and unregistered Sysops, although you should register after a trail period of 30 days! This documentation is in two parts, because of the size of the current documentation. The first file is called SDOC116A.ASC, the second one is called SDOC116B.ASC. Both files are set to 58 lines per page and do not contain any extended DOS charac- ters, except for the title page. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 001 SuperBBS will be distributed accordingly: - Alpha versions Not available. - Beta versions Available to all BETA testers. - Gamma versions Available to all registered Sysops. - Normal versions Available to everybody, including non-registered users. Updated documentation will only be available with the official releases. Beta and Gamma releases will have a special what's new file included. 1.2 SuperBBS credits -------------------------------------------------------------- Here are the credits for SuperBBS: Programming and design: Aki Antman and Risto Virkkala Documentation: Frank Hemmelder Protocol set up document & multiline document: Bob Henderson Protocol Engine (PE): Copyright Joaquim H. Homrighausen, 1.3 SuperBBS addresses -------------------------------------------------------------- How to reach the SuperBBS programmers: BBS name...........: SuperBBS HQ Telephone number...: +358.0.341.1398 Modem speed........: HST / V.32 DS Online hours.......: 24 Hrs Fidonet number.....: 2:220/620 SuperNet number....: 42:1200/101 Sysop..............: Aki Antman or by mail: Address............: Aki Antman (SuperBBS H.Q.) Porslahdentie 23 G 40 SF-00980 Helsinki Finland, Europe -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 002 How to reach the SuperBBS documentation writer: BBS name...........: NNN SuperBBS Telephone number...: +31.3480.24801 Modem speed........: V.32bis / V.42Bis / MNP5 Online hours.......: 24 Hrs Fidonet number.....: 2:500/239 SuperNet number....: 42:1100/101 Sysop..............: Frank Hemmelder or by mail: Address............: Frank Hemmelder (NNN SuperBBS) Lekoord 43 3448 VS Woerden Holland, Europe Bob Henderson has written two documents, one on protocol set up and one on running a multiline SuperBBS system. These files are available on most Support boards, or contact Bob at fido- net 1:3812/10. 1.4 How to contact us -------------------------------------------------------------- If you need to come in contact with us, there are several ways available. Here they are: - Send a letter to the address of the SuperBBS authors. Please include payment to return an answer. - Send a netmail message to the SuperBBS HQ BBS. Please include a Fidonet address to where the answer should be send. - Write a message in the international SuperBBS echomail area available in most countries. Your answer will also be posted here. Depending on the location you posted your message, this could take some time. - Write a message in the SuperNet echomail areas, available on most registered SuperBBS sites. FidoNet is a worldwide network, and contains over 8,000 sys- tems around the world, so it is easy to post a message from any country through Fidonet. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 003 1.5 Legal stuff -------------------------------------------------------------- Disclaimer: The authors of SuperBBS and the utilities are NEVER respon- sible for any damage occurring through the use of SuperBBS and/or utilities. We only guarantee that SuperBBS will take up space on your harddisk. It has been tested on several systems and it works there, but this doesn't mean it won't destroy your HDU or kill your cat or dog. Use at your own risk! However, if you do find an undocumented feature (= bug) or are having problems with running SuperBBS on your system, we would like to hear from you. Please contact us, so we might be able to fix the problem. SuperBBS may not be used in any UNLAWFUL manner or illegal activity. If this will happen, we will always inform the local authorities. You are not allowed to modify ANY of the executable or overlay files of SuperBBS or to change this documentation. The authors don't guarantee any future releases of SuperBBS. All files belonging to the SuperBBS package are copyrighted 1990-1992 by Aki Antman and Risto Virkkala. Documentation is copyrighted 1991-1992 by Frank Hemmelder. You are not allowed to modify, patch, disassemble (or anything like that) these files without the written permission from the copyright holders. You are not allowed to ship the SuperBBS programs, or part of the programs, in other software/hardware packages without written permission from the copyright holders. Sysops of bulletin boards are allowed to post the SuperBBS software package for download to their users in an unmodified version and as long as no charge is asked for downloading the software. It is not allowed to add BBS commercials to the software archive. The use of a ZIP or ARJ header is however allowed. Sysops should make it possible for all their users to download the SuperBBS package if requested by the user. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 004 1.6 How to register -------------------------------------------------------------- SuperBBS is released under the ShareWare concept, so you can try it for 30 days before you have to register this product or stop using it. If you are using this software after the 30 days trail limit, you MUST register. This software is not cripple in any way. You can test the whole package. Please support the shareware concept. Through this concept it is possible to test the software before paying for it. If you decide the software is 'just what you wanted', you will need to register. If you don't register, you will violate the Shareware concept. This could mean that the next version will be a commercial one, so you won't be able to try it before buying. > Register ShareWare - Guarantee the future of SW programs. < Registration of SuperBBS entitles you to use the software after a period of 30 days. It will also give you access to the SBBS Gamma releases, which are only available to registered users. Registration entitles you to use any SuperBBS release up to version 1.99. (Currently v1.16) This will take a long time and many new releases and improvements. 1.6.1 Registration in FINLAND only -------------------------------------------------------------- Send FIM 200,- to the account: '710125 - 313639 STS', _PAY- ABLE_ to Risto Virkkala and send in the registration form with the following information: - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to Please note that upper and lower case are different! - Your real name - Your address - Your voice and data phone numbers - Your FidoNet address (if available) When we received your payment, your registration code will be posted to you. This can take some time, so please be patient. 1.6.2 Registration abroad -------------------------------------------------------------- Send US $50 cheque or money order to the SuperBBS HeadQuarters address posted. Make cheques payable to: Risto Virkkala. Make sure your shipment arrives in good order. Creditcards can't be accepted at this moment. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 005 Please include the following information. Note that upper and lower case are different with the registration names! - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to - Your real name - Your full address including Country - Your full (international) voice and data phone numbers - Your Fidonet address (if available) If you are part of Fidonet, please include your BBS opening hours, so we can crash your registration key to your board. This will give a faster turn around time then by mail. You will receive your registration key after we have received your money. Please do allow some time for processing and handling. Registrations are also possible at some of our Support sites. Please check the file HOWTOREG.TXT included in the main BBS archive for more information. 1.6.3 Site registrations -------------------------------------------------------------- Site registrations are also available: 5-9 boards..... US $45 10-more boards..... US $40 Please authorize one of you to register all boards on the site. This person has to send us the information and money for the registration and we will send him/her the registration codes for all boards. Do not send the money separately! Send money and information required to the SuperBBS HeadQuarters. Site licenses are not available at the Support sites. This service is only for site licenses, not for Sysops who register together with different BBS/Sysops names. 1.7 Differences registered/evaluation -------------------------------------------------------------- There are some differences between the registered version of SuperBBS and the evaluation copy. The evaluation copy is however not crippled and can be used to evaluate the program in all available aspects. The only differences between evalu- ation and registered copies are: -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 006 When somebody is login in to your system, a message will be displayed to him/her: Registered version: "SuperBBS v1.16, registered to: <Your name>" Unregistered version: "SuperBBS v1.16, unregistered evaluation copy." This message will also be displayed if you choose the display version number menu item. The tearline in the echomail areas originating from your board will look like: Registered version: "--- SuperBBS v1.16 (Reg)" or "--- SuperQWK v1.16 (Reg)" when using the QWK option. Unregistered version: "--- SuperBBS v1.16 (Eval)" or "--- SuperQWK v1.16 (Eval)" when using the QWK option. 1.8 Distribution files -------------------------------------------------------------- SuperBBS is distributed in an archive named 'SBBS_nnn.xxx', where nnn is the version number and xxx the archive type. Please do not modify this file in any way. Do not add your own adds to the archive. (Some archivers do however allow you to add a archive header.) The file DESCRIPT.ION lists all the files which should be in the archive you received. Do not distribute modified archives! Also included is an archive with startup files, which makes it possible for you to start a bulletin board in a short time. Documentation concerning registration, update information, technical descriptions and menu types is also included. If you received more or less files, you have a modified archive. You should not distribute this file any further and get a complete version from one of the distribution nodes. You may distributed the unregistered version of SuperBBS freely, as long as no fee is asked or any profit is made. Please make sure all users of your bulletin board are able to download the SuperBBS archive. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 007 Chapter 2. Installation ============================================================== 2.1 General information -------------------------------------------------------------- SuperBBS is a very flexible program. Please read this documen- tation carefully. Although the program is complex, it is not hard to set up a bulletin board system with it. Have a look at the samples if you are new to running a bulletin board. This will help you to get a BBS up and running in a very short time. If you do however run into problems, consult this manual again and if you still have problems, contact one of the support boards or the authors. The SuperNet echomail area is also available to ask questions and it often will give you hints from other (more experienced) SuperBBS users. 2.2 Software requirements -------------------------------------------------------------- Besides the SuperBBS files, you will need some external files before you can run SuperBBS. These files can differ from system to system, depending on the way you have set it up. You will at least need these files, or compatible: MS-Dos Sounds logical, without this your system won't even run (or not with an operating system SuperBBS will run in). You'll need version 2.0 or higher. SuperBBS has been tested with Ms-Dos up to version 5.00, but version DOS 3.3 to 5.x is recommended. Su- perBBS has also been tested with 4DOS from JP Software (TM) and works fine with ver- sion 4.00 and older. X00.SYS Fossil communications driver, a good re- placement is BNU. SuperBBS will not run without this file! (Except in Local mode.) QUICKED.EXE The full-screen editor. (This file is optional.) THEDRAW.EXE Or any other ANSI/ASCII text editor. This program will help you design your ANSI and ASCII support files. (This file is optional.) Most QuickBBS files work with SuperBBS. Please keep in mind that SuperBBS is much bigger than QuickBBS and there could be programs which will work perfect on a QuickBBS system, but not, or not complete, on a SuperBBS system, because there are many differences between the two programs. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 008 2.3 Hardware requirements -------------------------------------------------------------- Some hardware is needed to run SuperBBS. SuperBBS uses about 250 Kbyte base memory and can use EMS memory for the overlay file. This memory requirement is for SuperBBS only. When run from a batchfile, you will need to reserve more memory. Other requirements are: Harddisk A harddisk with at least 2 MB of free diskspace is needed to set up SuperBBS. You'll probably need more if you set up a lot of utilities to run under SuperBBS and have many mail areas. A system with 70 mail areas (6000 messages), 30 file areas and 10 online games uses around 20 MB of disk space for the systemfiles and support programs. The files in the file areas are not included here, only the support files for the file areas. Hayes Modem A Hayes compatible modem, either internal or external, is needed. Speeds up to 38400 Bps are supported. When running a multi-node system with Desqview (TM) or Windows (TM), a 80386DX processor is recommended. Running single line is possible on a slow XT, although a 80286-12 or higher is preferred. Running multiline in a network is also possible. 2.4 Unpacking the software -------------------------------------------------------------- Move your SuperBBS archive to the main directory you want your BBS files in. (In our example C:\SBBS) Unpack the archive. You can move the documentation files to another directory if you want. Make a directory for your menu files, your textfiles, the TEMPDIR and a working directory. Also create a directory for your message files if you don't want them in your main BBS directory. You would get something like this (for single line operations only): C:\SBBS C:\SBBS\TEXT C:\SBBS\MENU C:\SBBS\MAIL C:\SBBS\TEMP C:\SBBS\WORK C:\SBBS\NODELIST (Optional) C:\SBBS\ATTACH (Optional) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 009 Now you need to start the configuration program CONFIG.EXE. Please refer to the part of this documentation concerning the CONFIG.EXE program. The directory set up for the multi-node operations is a bit more difficult. You will have to make a directory for every node you plan to run, even if it's only a local node. Your directory set up could look like this: C:\SBBS C:\SBBS\LINE1 C:\SBBS\LINE2 C:\SBBS\LINE3 C:\SBBS\MAIL C:\SBBS\TEMP1 C:\SBBS\TEMP2 C:\SBBS\TEMP3 C:\SBBS\WORK1 C:\SBBS\WORK2 C:\SBBS\WORK3 C:\SBBS\NODELIST (Optional) C:\SBBS\ATTACH (Optional) E:\ Place the executable programs in the SBBS directory and set your path statement showing this directory. Run the configur- ation program from the single line directories, i.e. line1, line2 and line3 in this example. You will have to set up a TEMP directory and a WORK directory for every line in use. The E:\ drive is a RAM disk and is the common directory for all nodes. You can also use a normal disk if no RAM drive is available. But a RAM disk is faster. 2.5 Configuring SuperBBS -------------------------------------------------------------- CONFIG.EXE is the main installation program for SuperBBS. You need to run this program to set all settings correct for your system. You can run the configuration program as often as you like, it will ask you if you want to save the current con- figuration when you exit the program. When you start CONFIG.EXE, you will be presented with the following options and sub-options: ? (2.5.1) Registration (2.5.2) Information (2.5.2.1) Registration (2.5.2.2) Messages (2.5.3) Message areas (2.5.3.1) Global options (2.5.3.2) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 010 Messages (continued) Netmail (2.5.3.3) QWK Setup (2.5.3.4) Files (2.5.4) File areas (2.5.4.1) Global options (2.5.4.2) Internal protocols (2.5.4.3) External protocols (2.5.4.4) Modem (2.5.5) Initialisation (2.5.5.1) General options (2.5.5.2) Other (2.5.6) New users (2.5.6.1) General options (2.5.6.2) ON/OFF settings (2.5.6.3) Restrictions (2.5.6.4) Alt-F? keys (2.5.6.5) String configuration (2.5.6.6) Door configuration (2.5.6.7) Multinode configuration (2.5.6.8) Event editor (2.5.6.9) Define keyboard password (2.5.6.10) Colours (2.5.7) Message/filebase (2.5.7.1) General (2.5.7.2) Message reader (2.5.7.3) Limits (2.5.8) Paths (2.5.9) Quit (2.5.10) The numbers between brackets are the chapter numbers for easy references. Moving around the different options is done by the cursor keys. To open a certain option you have to press ENTER. Press- ing ESC will bring you one step back, or will exit the pro- gram. You will be asked if you want to save the configuration before you exit the program. All available configuration options will be explained below. The following notation standard will be used: Type.........: Name of the current option Description..: Explanation of the option and it's function in the BBS program. Options......: The available options. 2.5.1 ? -------------------------------------------------------------- This will give you some information about the SuperBBS program and the makers. No further sub-options available. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 011 2.5.2 Registration ------------------------------------------------------------- Here you will enter the information about your registration. You have to register SuperBBS after a 30 day trail period, or you have to stop using it. 2.5.2.1 Information ------------------------------------------------------------- The information option will give you some information on how to register. No further sub-options available. 2.5.2.2 Registration ------------------------------------------------------------ The registration option has the following fields available: Type.........: Sysop name Description..: The name of the person who registered the SuperBBS program. This must be exactly the same as on your registration, otherwise the system will not display the 'registered' message. Normally this is the Sysop's name. Any message written to 'Sysop' will be addressed to this name. Options......: Name Type.........: System name Description..: The name of your system as set on the registra- tion form. This has to be an exact match, or SuperBBS will not display the 'registered' message. Options......: Name Type.........: System location Description..: Place where your BBS system is located. Your free to enter what you like in this field. This is used to display the location of your system while the user is downloading files. (Frontdoor displays this information for example during down/upload.) Options......: City Type.........: Registration code Description..: The registration code as supplied by the authors of the SuperBBS program. This code will unlock all features in SuperBBS only available to registered users. Leave this the way it is if you run an evaluation copy. Options......: Registration code -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 012 Type.........: Beta code Description..: Registration code for BETA testers of the SuperBBS program. (Currently there are BETA testers enough. Only when you run a special configuration, like a network, you could apply for a BETA tester code.) This code only works if code A is available also. Options......: Registration code As of version 1.15, there is a new security feature build in to SuperBBS. When running a registered version of SuperBBS, you will need to have a valid .SCC file. Without this file your system will not run. Once you have a correct .SCC file, you will NOT need to download a newer .SCC file when they come available. When you register, you will get a key and a .SCC file. Check the support nodes for more information on this subject. 2.5.3 Messages -------------------------------------------------------------- SuperBBS allows the use of 200 message boards. It has a build in offline reader, QWK, so you can let your users download the messages and read them offline. 2.5.3.1 Message areas -------------------------------------------------------------- SuperBBS allows you to setup 200 different message areas. All these areas have their own security levels and flagsettings. SuperBBS even allows you to have different origin lines for every message area. You can move around the fields through the use of the arrow keys. The [PgUp] and [PgDn] keys will skip you to the previous or next message area. [ESC] will return you to the main menu. With [F1] you can move to an area by entering the area number. Type.........: Name Description..: Name assigned to the current message area. leave this blank if you want to skip this area. This name will appear in the change message area menu build into SuperBBS. It can also be displayed in your menus or textfiles when using menu templating. Options......: Name -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 013 Type.........: Short QWK name Description..: SuperBBS allows as of version 1.16 longer names for the message areas. Since QWK cannot handle these long names, you have the option to enter a shorter name for use in the QWK offline mail reader. Options......: Short name Type.........: Type of messages Description..: SuperBBS has three different type of messages. Which to use depends on the way you want to use the message area. The available types are: 1. Standard. This type is used for local areas on your bulletin board system. 2. Netmail. This type is used for your netmail area(s). You should have defined the area number in the netmail part of the con- figuration program. User's will be asked to enter an address (fidonet style) where to send the message. 3. Echomail. This type is used for echomail messages. These are mostly public and an origin line will be appended to every message written in this type of area. Most echomail areas don't allow the use of aliases. Normally you would have 1 netmail area, a couple of local areas and some echomail areas. Options......: 1,2 or 3 Type.........: Status of messages Description..: There are four different type of messages in SuperBBS available, depending on the type of message area you choose in the above option. The types are: 0. Both public & private This type of messages is normally used in your local message areas. The user will be asked if the message is private or not. private messages can only be read by the writer, the addressee and people having Sysop access level. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 014 1. Private messages only This type is mostly used in your netmail area and the local Sysop area. All the messages will be private and can only be read by the writer, addressee and people having Sysop level. Note that private mes- sages send to other systems can be read by the Sysops where the message is passing through. 2. Public messages only This type of messages is mostly used in echomail areas, since the message can be, and need to be, read by everyone. No pri- vate messages are allowed in (Fidonet) echomail. 3. Read only messages This type of messages can be read by everyone having access, but no messages can be written and no replies are possible with this type of messages. People having Sysop level can read all private and public mail, even if this mail is not addressed to them or originating from them. Please tell your users this is the case, so they know. Options......: 0,1,2 or 3 Type.........: AKA to use (0 = primary) Description..: SuperBBS allows you to have different addresses for every mail area you have defined. (Mostly only useful on Echomail areas.) The 0 stands for the primary address, see netmail part of configuration, while 1 to 10 stands for the AKA's. This allows you to have an area for one fidonet and one for another. Options......: 0,1,2...9 or 10 Type.........: Minimum age Description..: Age the user must have to access the message area. If the user is to young, a message will be displayed. Options......: Age -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 015 Type.........: User names Description..: This option allows you to give users the option to use their alias in the 'From' field of the message. Please note that most echomail areas don't allow the use of an alias. You have the option to allow several aliases, only the alias used in the BBS, force the use of an alias or don't allow aliases. Options......: No alias/Ask alias/Force alias/Alias & name Type.........: Reply status Description..: This option is not yet supported by SuperBBS. Options......: None Type.........: Combined Description..: Will the message area be available from the combined board? This special message area, number 0, displays all available messages to the user in numerical order and not separated by area. Options......: Yes/No Type.........: Default combined board Description..: If you want this message area to be in the combined board by default, switch this option on. Note that the user can still deselect the area. Options......: Yes/No Note that currently the combined area select is also used as the area select for the QWK mail reader. Type.........: Allow delete Description..: Are your users, without having Sysop access to the mail area, allowed to delete messages which are addressed to them or originating from them? Messages not belonging or addressed to the user will not be deleted. Options......: Yes/No Type.........: Allow taglines Description..: QWK allows the user to add a 'tagline' to the messages written with a QWK offline reader. These lines are more for fun then for informational purposes, and not every echomail area allows the use of taglines. You can now select which areas will have taglines and which will not. Note that this option is for the QWK part of SuperBBS only. Option.......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 016 Type.........: Template Description..: With this option you can make an area available to the template menu. If this option is switched of for an area, this area will not be shown in the menu type 68 area change command. This allows you to have some areas separated from the other areas. You can only access the area by telling SuperBBS it has to go to the specific area in the menu commands. Options......: Yes/No Type.........: 8bit ---> 7bit Description..: Convert all 8 bit characters, which are not allowed in some echomail areas, to 7 bit char- acters. Options......: Yes/No Type.........: Group Description..: As of version 1.16, SuperBBS allows you to have your message areas in groups. This allows you to give certain users only access to certain groups of messages. For example, Group L are all the local mail areas. Group F is Fidonet and group S is SuperNet. The area change com- mand has an extra option to show only the areas belonging to the specified group. Options......: Group character (A to Z) Type.........: Force mail check Description..: This option will force this area to always be checked at a new message check. Options......: Yes/No Type.........: Read security level Description..: Security level of the user needed to read mess- ages in this area. If the user doesn't have the correct level, he/she will be displayed a mess- age, stating that access has to be granted. Options......: Security level Type.........: Read flags A to D Description..: These are the flagsettings you can use to give somebody permission to read a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Write security level Description..: Security level of the user needed to write messages in this area. If the user doesn't have the correct level, he/she will be displayed a message, stating that access has to be granted. Options......: Security level -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 017 Type.........: Write flags A to D Description..: These are the flagsettings you can use to give somebody permission to write a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Sysop security level Description..: Security level of the user needed to have the extra Sysop options available in this area. User's who have this access will be able to read, delete, edit, copy and change attributes of all messages, private or public, in this area. Options......: Security level Type.........: Sysop flags A to D Description..: These are the flagsettings you can use to give somebody permission to sysop level in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Origin Description..: SuperBBS now allows you to edit the ECHOORIG.CTL file, which contains the origin lines for the different areas, from within the configuration program. SuperBBS will write these origin lines to the ECHOORIG.CTL file, which is a plain ASCII file. Please note that when no origin is filled in, the default origin is used. Options......: Origin line All these options have to be set for every message area you want to use, except for the origin, which is optional. You can change the settings at any time. If you want to delete a mess- age area, just delete the area name. SuperBBS will not show the area as long as the area name is blank. 2.5.3.2 Global options -------------------------------------------------------------- Type.........: Net/echo exit Description..: This option tells SuperBBS to exit with a special errorlevel if the user entered net and/or echomail messages. This allows you to run the mail processor to pack the mail. (Continued on next page) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 018 SuperBBS will exit with the following error- levels: 5 - Both net and echomail entered 4 - Only echomail entered 3 - Only netmail entered This allows you to adjust your batchfile in the correct way. Options......: Yes/No Type.........: Allow @ control characters Description..: Special @ control characters are replaced in a message with a certain value, depending on the character used. It is possible for users who know these codes to generate messages like: Hey dude, what's ....... for a password. The ..... is then replaced by the current user's password. Although the writer of the message couldn't see the next user's password, the user still might think so. The message writer used a control character to display the current user's password. So use this option with care, not every user is as honest as you. Options......: Yes/No Type.........: Check mail at logon Description..: If this option is enabled, SuperBBS will scan the message base for any unread messages addressed to the user (or it's alias) and dis- play them. The user has the option to read them or to skip them. If disabled, no messages will be scanned. Options......: Yes/No Type.........: Fast mail check Description..: SuperBBS normally scans the whole messagebase for messages unread by the user. With this option enabled, it will start at the last read pointer, making it faster, but less accurate. Some echomail processors do weird things with the lastread pointers, causing messages to be missed in the mail scan. This is not a SuperBBS problem, but a problem with the echomail pro- cessors. Even with over 5000 messages the nor- mal message scan will only take a couple of seconds to complete. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 019 Type.........: 8bit --> 7bit in echos Description..: SuperBBS allows the use of 8 bit characters and can convert these to 7 bit in echomail areas. In some countries are 8 bit characters not allowed. If you switch this function off, 8 bit characters can not be used in echomail areas. (SuperBBS will translate them to 7bit charac- ters.) SuperBBS now allows you to set this for every message area separate in the message area configuration menu. Options......: Yes/No Type.........: Coloured quotes in messages Description..: You can now display quotes in messages in another colour. You will have to use ANSI to see the colours. SuperBBS will scan for the > sign, to determine if the line is a quote or not. Options......: Yes/No Type.........: Group mail at logon Description..: SuperBBS allows the use of group messages, messages to all users, or certain security levels. To scan for these messages, you will have to set this option to Yes. If set to Yes, group messages will be scanned at logon. Options......: Yes/No Type.........: Show userlist in type 27 Description..: If a user enters a name of a user in a local mail area and this name does not exist, Super- BBS allows the user to scan the user list for the correct name. If this option is enabled, SuperBBS will display the userlist. Options......: Yes/No Type.........: Match senders zone Description..: If your part of Fidonet and have more addresses, AKA's, SuperBBS can match the zone of the message your replying to, if their is an AKA in that net. Take for example a message from net 2. SuperBBS will use your zone 2 address to reply on the message. If the orig- inating message would come from a zone 42 sys- tem, SuperBBS would use your zone 42 address. If you receive mail from a zone 77 system, SuperBBS will use your main address to reply, if you don't have a zone 77 address. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 020 Type.........: Real message numbers Description..: Normally the messages in SuperBBS are numbered from 1 to xxxxx in ascending order. Every new message will get the latest message number + 1. If you enable this option, SuperBBS will number the messages per area. So area 1 will have messages numbered 1 to xxxx. So will area 2 and so on. Internally SuperBBS still uses the nor- mal message numbering system, and it does so in area 0, the global read area, but for the user it will number every area from 1 to xxxx, mak- ing it easier to read individual messages or the last xx messages. Note that this only applies to the interface to the user. For your echomail processor or any other program, Super- BBS still uses the normal count. Options......: Yes/No Type.........: Line editors quote mode Description..: SuperBBS allows you to have three options here. The first is no quotes, in which case no quotes are possible of the message replying to. Than there is normal quotes, which will print the complete message replying on in the new mess- age. The third option is intelligent quotes, in which case SuperBBS will ask the user if he/she wants to quote the line. It will do so for every line in the message you are replying to. This last option is the best, as it keeps quoting small, which means cheaper echomail. Options......: No quote/Normal quotes/Intelligent quotes Type.........: Show user's real name in group mail Description..: When you allow your users to write group mail messages, you might want to make sure that only their real name is displayed and not their alias. This option allows you to do so. If switched off, the alias is shown, when used to write the message. if the real name is used to write the message, the real name is shown, even when this option is set to no. Options......: Yes/No Type.........: Quote string Description..: String which will be displayed when quoting a message. This string will be placed in front of the message lines you are quoting. The standard quote string in SuperBBS will give you the two first characters from first and lastname of the writer of the message your quoting. Options......: Quote string (Example: >) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 021 Type.........: Comment answer board Description..: Message area number where all the replies on the logoff comments are stored. If you set this to 0, no replies are possible. Normally you would use your local 'general' message area for this. Options......: 0 = Not in use n = Message area number Type.........: Password failure board Description..: Number of the message area where the user can leave a message if he/she forgot his/her pass- word and sends a message to the Sysop. If you set this to 0, no messages will be allowed. The user will be logged off after writing the optional message. Mostly the Sysop area is used for this type of messages. Options......: 0 = not enabled n = message area number Type.........: Message after page board Description..: Message area number where the messages from user's who tried to page you are stored. If a user tries to page you and you don't react, SuperBBS will ask the user if he/she would like to leave a message. Options......: 0 = not enabled n = message area number Type.........: Group mail security Description..: Security level needed to write a group mail message. Group mail messages are messages to all users or certain security levels. (See the message base chapter for more information.) Options......: Security level 2.5.3.3 Netmail -------------------------------------------------------------- This part is only of interest to you if you are part of Fidonet or another network. Systems in a network exchange netmail and echomail and are using a network address. In the netmail part you will specify your address and your AKA's. AKA's are fake addresses used by some BBS systems which have a node address in more than one (Fidonet like) network or zone. You can obtain a network address at a network administrator. Ask a local sysop who is connected to a network how to contact the administrator. Do not use a number of your own choice. If you are no part of a network, leave the fields as they are. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 022 An example: 2:220/620. This is a BBS in Europe (Zone 2). Net 220 is in Finland and number 620 is Aki's system. SuperBBS has Nodelist support and also Point addresses are supported. Type.........: Main address Description..: The number of your main address. This number consist of four parts: zone, net, node and pointnumber, although the pointnumber is left out for most BBS systems. Options......: Zone, net, node and pointnumber Type.........: AKA Address #1 to #10 Description..: See main address. If you don't use more than one address, leave this as it is. SuperBBS does support zone matching when replying to netmail. Options......: Zone, net, node and pointnumber or 0. Type.........: Netmail board Description..: Message base area (between 1 and 200) which will be used to store netmail messages. You also have to setup this area in the message base configuration part of the program as being a netmail area. Set this to an unused area if you are not using netmail. Options......: Message base number (between 1 and 200) Type.........: Crashmail security Description..: Security level needed to send CRASH mail. This is mail which (mostly) is send straight after you leave the BBS. This is depending on how your mailer system is setup. Please consult your mailer documentation for further informa- tion. Options......: Security level 2.5.3.4 QWK setup -------------------------------------------------------------- SuperBBS has a build in mail reader. Mail readers are used to download messages from your system, read them while the user is offline and then upload the replies or/and new messages. This way you can save your users a lot of money on their phonebill and still give them a lot of (echo)mail. As a user you will need a mailreader to read and answer/write the mess- ages. One mailreader for the QWK system is the Silly Little Mail Reader (TM), or SLMR. Currently version 2.1a is avail- able. Other mail readers are available. Also other reader- -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 023 systems are available, but all have to be run as external programs. The QWK mailpackage will contain your welcome and goodbye screens, as well as your NEWS.A?? file, so the user will see these also at his own system when reading mail. QWK message packages are created in the WORK directory set in the configuration of SuperBBS. Please make sure that the directory is setup correctly. When run locally, the files will be stored in this directory and you can move the file from their to diskette or another directory. No protocol screen will be shown when run locally. Type.........: Unique BBS ID Description..: This unique BBS ID is used by QWK to name your mail package. Please make sure this is a unique ID, and don't use the example. If a user down- loads mail from more than one system, he/she will have to guess which package came from which BBS by looking at the name. The BBS ID has to be a DOS like filename, since it is used to name your mail package. (That means you can't use the * or ? characters for example.) QWK will add the .QWK extension to your pack- age. Options......: BBS ID name (8 characters) Type.........: Default QWK board Description..: Message board used to store messages which violate the rules, i.e. a bad message, on the BBS concerning read/write access to a certain area. If a message is violating a rule, it will be placed in the default area. Options......: Area number (1 - 200) Type.........: Max. number of messages Description..: Sets the maximum amount of messages to pack in one mail package. Users are able to decrease this amount at the moment they are getting their mail. Options......: Number of messages Type.........: Allow TAG lines Description..: Most mail readers allow you to add a Tagline, a little line of text not concerning the message. The BBS will add a origin line, this would mean their are two origin lines in the text, which is illegal in most echomail areas. This option allows you to specify where Taglines may be used. You can now specify this option per mess- age area in the message area configuration part of this configuration program. Options......: No taglines/Always -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 024 Type.........: Use ZIP/LZH/ARJ/ARC packets Description..: Here you can specify from which archivers your user can choose to pack his/her mail with. You will need to place the archivers in a directory reachable through your path statement. Options......: Yes/No The QWK support for SuperBBS is based upon MkQwk written by Mark May. Support QWK, get your users to use it. 2.5.4 Files -------------------------------------------------------------- SuperBBS uses a file called FLSEARCH.BBS to store it's file areas in. This file is edited through the file area editor. Please note that this file is not plain ASCII, like the QuickBBS file FLSEARCH.CTL. 2.5.4.1 File areas -------------------------------------------------------------- When you are in the editor's main screen, you'll see one open window. Here you choose the file area to edit and insert and delete file areas. The following keys are active: [RETURN] Edit the area marked by the inverse bar. [INSERT] Add a new area to the file area list. [DELETE] Remove an area from the file area list. [CURSOR] Move around the file area list. [F1] Converts FLSEARCH.CTL to FLSEARCH.BBS. [ESC] Return to main configuration menu. When you choose a file area, a second window will open, dis- playing the options available per file area. You can move around with the cursor keys and pressing [ESC] will return you to the main window. These options are available per file area: Type.........: Name Description..: The name you want to give to the area and which will be displayed at a newfiles scan and if you do an area change through the build in menu command. Options......: Area name -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 025 Type.........: Directory Description..: The dos directory path to your directory. This is the place where the files are, so people can download them. The backlash at the end of the pathname is optional. Options......: Drive:\Pathname Type.........: List name Description..: Drive, directory AND filename of the FILES.BBS file for this file area. This option is only needed if you use a CD-Rom drive and want your FILES.BBS in another directory, because a CD- Rom is read only. If you leave this space blank, SuperBBS will look for the FILES.BBS list in the directory given in the directory option above. A second option is now available. You can use the list name line to tell SuperBBS where to place the uploaded files. This will be the case if you enter a directory here with an asterisk '*' in front of the directory. For example: c:\files\datacom\files.bbs is the place where the files.bbs file is stored, but: *c:\files\upload is the place where the uploaded files have to be placed. Please note that some allfiles list- ers, like FEBBS and ALLRA, are not working correctly when you use this option. Options......: Drive:\Pathname\Filename.ext or *Drive:\Pathname Type.........: Security Description..: The security level needed to access files in this area. Options......: Userlevel Type.........: Age Description..: The lowest age needed to access this file area. this option only works if you have the birthday option in config.exe enabled. Options......: Age Type.........: Flags A to D Description..: Flagsetting needed to gain access to the file area and available files. (X = On/- = Off) Options......: X Type.........: Template Description..: SuperBBS allows the use of menu templating. This means you can have one menu for all avail- able file areas. (See the part of the documen- tation on menus.) If you don't want the file area to be part of the menu templating, disable this option. SuperBBS will save the template information in the user record, so the user will be in the same area when entering the menu the next time. Options......: Yes/No Type.........: Downloads Description..: Option to disable downloads from the area. If set to 'No', no downloads are possible from this area. Options......: Yes/No Type.........: Uploads Description..: Option to disable uploads to the area. if set to 'No', no uploads are possible to this area. Options......: Yes/No Type.........: Virus check Description..: SuperBBS can scan uploaded files for viruses. if you don't want files to be checked in the file area, disable this option. Options......: Yes/No Type.........: Dupe scan Description..: SuperBBS will check all file areas for dupes when a user wants to upload a file. This could take a long time when you have a CD-Rom player attached to your system. This option allows you to disable this dupe check for the area. Options......: Yes/No Type.........: New scan Description..: When scanning the file areas for new files, you can now disable areas from this scan, for example CD-Rom areas. Areas switched off will not be scanned for new files. Options......: Yes/No Pressing [ESC] will save the information. You can always change the information. Pressing [ESC] from the main window will put you back in the main configuration menu. 2.5.4.2 Global options -------------------------------------------------------------- Type.........: Check files at logon description..: When enabled, SuperBBS will scan the filebase and search for any new file and display these to the user just after the mailscan at logon. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 027 Type.........: WatchCD at (un)pack Description..: SuperBBS can watch the carrier while files are extracted and repacked during a virusscan. If a user disconnect during the archive operations, SuperBBS will continue and then, when finished, will bring the system back to it's starting position, ready to accept callers. Options......: Yes/No Type.........: Uploader to Files.bbs Description..: It is now possible to display the name of the uploader in the Files.bbs file just below the filedescription. Note that this option uses the option with the > character. (See below.) Options......: Yes/No Type.........: Use > in long descriptions Description..: There are two ways of displaying longer file descriptions in the Files.bbs file. The first is through the use of the build in line wrap. SuperBBS will break the line and continue at the next line at the 14th position if the line is longer than the screenwidth. When you use this option you can't use the uploader name in the Files.bbs option. (See above.) The second option is to make use of the > character. Lines preceded with this character are placed on the 14th position in the Files.bbs file when dis- played to the user. (They should be on the second character in the Files.bbs description when editing the description. See the Files base chapter for more information on these options.) You can toggle between the two options with this configuration option. Options......: Yes/No Type.........: Strict dupe checking Description..: SuperBBS has two ways of checking for dupe files. The first is by name and extension, the second one is on filenames only, without exten- sion. The second one will find a file called SBBS_115.LZH when the file SBBS_115.ZIP is about to be uploaded. The first option would not find the file, because it would look for the complete name, including the extension. If the strict dupe checking is enabled, SuperBBS will only scan for the filename and not on the filename with extension. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 028 Type.........: Free file time checking Description..: When downloading free files SuperBBS will either check the time of the user or not check the time. Time checking can be done on the users time limit or on event time. This allows you to have free files, but a user won't be able to download them when the download would exceed the event time or user's time. Options......: No checking/Time limit check/Event time check. Type.........: Virus check Description..: When a user has done an upload, SuperBBS has the ability to scan the file for known viruses. The viruscheck will be performed right after the user has done the upload. SuperBBS is very flexible in which scanner to use or what to do with an infected file. You will need the fol- lowing programs (all trademarks of their res- pective companies) when using this option: - PKZIP.EXE - PKUNZIP.EXE - PKARC.EXE - PKXARC.EXE - LHA.EXE - PAK.EXE - ARJ.EXE - Virusscanner These files have to be in a directory which is available through the path statement. When a virusinfected file is found, SuperBBS has the option to exit with an errorlevel, so you can do with the file what you want by taking the appropriate steps in your batchfile. Options......: Yes/No Type.........: (Un)pack swapping Description..: Swap part of SuperBBS to EMS or disk when pack- ing or extracting files. Options......: Yes/No Type.........: Unpack before scanning Description..: This option allows you to tell SuperBBS not to unpack any files before a virusscan is done. This is useful for viruscheck programs which can scan inside an archive. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 029 Type.........: Use file date touching Description..: Do allow SuperBBS to change the date and time of a file uploaded to your system. Normally SuperBBS will change the date and time of the file so it will be shown in the newfiles scan. If this option is enabled, the original file date will not be preserved. If this date is older than the current date, the file will not be shown in the newfiles scan. Options......: Yes/No Type.........: Allow file flagging Description..: As of version 1.16 of SuperBBS, the program supports file flagging. This allows your users while viewing the files lists and newfiles list to flag files for download. When the user than selects download, he/she will be given the option to download the flagged files. Options......: Yes/No Type.........: Extended new files check Description..: Normally SuperBBS will scan for newfiles since the last logon of the user. Now you have the option to do this from the last time the user did the newfiles scan. This means a user can call six times a week, but only once a week he/she will do a newfiles scan. Now it is poss- ible to scan automatically from the last time he/she did the file scan, instead of the last call. The user can always change the date the newfiles scan has to start. Options......: Yes/No Type.........: Upload credit multiplier Description..: This option allows you to control the way SuperBBS reacts to an upload. You can give the user back the time spend on the upload or even double or triple it. Or you can do nothing with it. Options......: 0 = Not activated 1 = Returns time spend on upload 2 = Returns double time spend on upload 3 = Returns triple time spend on upload 4 = And so on........ Type.........: Minimum upload space (KBytes) Description..: Minimum diskspace which has to be free before SuperBBS will let the user do an upload. If the space is not free, user's can't upload. Options......: Number of Kbytes -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 030 Type.........: Download counter left bracket Description..: SuperBBS has a build in download counter. With this option you specify how the left bracket of the downloadcounter will look like. If left empty, the downloadcounter is disabled. Options......: Left bracket Type.........: Virus found errorlevel Description..: Errorlevel which SuperBBS will use to exit after a virus has been found in a file. This allows you to adjust your batchfile to take care of the virus infected file. Options......: Errorlevel Type.........: Files before ratio check Description..: Number of files a user can download, before SuperBBS will check the file ratio in Kbytes and files. Options......: Number of files Type.........: Maximum file description lines Description..: Number of lines available when giving a file description before or after doing an upload. SuperBBS now wraps the line around if the line is longer than 45 characters. It will display the wrapped text at the right location in the FILES.BBS list. Or you can use the > character. Options......: Number of lines (1 to 5) Type.........: Download counter right bracket Description..: SuperBBS has a build in download counter. With this option you specify how the right bracket of the downloadcounter will look like. If left empty, the downloadcounter is disabled. Options......: Right bracket 2.5.4.3 Internal protocols -------------------------------------------------------------- The internal protocols can be toggled on or off, making it possible to use another Zmodem (or other internal protocol replacement) protocol. The following protocols are available in SuperBBS: - Zmodem - Ymodem batch - Xmodem - Xmodem 1K (Ymodem) - Xmodem 1K G - Ymodem-G -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 031 You can toggle these protocols on or off by changing the Yes to No or vice versa. The internal files are all called by the EXTPE.EXE program. Make sure this file is in your path. 2.5.4.4 External protocols -------------------------------------------------------------- SuperBBS supports external protocols for downloading and uploading. It is one of the first bulletin board programs to directly support Bimodem as an external protocol. There are 20 definable protocol options available. Please note that every protocol installed adds 650 bytes of memory to the main BBS program. The configuration of the external protocols is somewhat more complicated. There are several options available here: Command......: Activated Description..: Indicates if the protocol is active or not. If active it will be shown in the up/download list with menu types 32 and 33. They will also be displayed with menu type 48. Options......: Yes/No Command......: Name Description..: The name of the protocol as it will be dis- played in the up/download lists with menu types 32, 33 and 48. Options......: Protocol name Command......: Key Description..: The character which identifies the protocol in the up/download lists with menu types 32, 33 and 48. Options......: Character Command......: Batch Description..: Defines if the protocol is a batch protocol or not. This means if the protocol can download more than one file at a time. (Zmodem can for example, but Xmodem cannot.) Options......: Yes/No Command......: Protocol type Description..: Defines the type of protocol you are using. There are three options. Option one is Bimodem, which you need to use if you install bimodem. The second option is other, which you need to use for all other protocols not using the Bi- modem interface. Options......: Bimodem/Other -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 032 Command......: Log style Description..: protocols have different ways of writing a logfile. To support all these logfiles, Super- BBS has the option to support three types of logfiles. These are DSZ, used by many programs, Icom, used by Bimodem, and other. Options......: DSZ/Icom/Other Command......: Download command Description..: This is the most difficult one of the external protocol installation (with the upload com- mand). Here you specify how the protocol has to be called by SuperBBS. You will have to specify the protocol name and all options needed to run the protocol. See the examples later in this chapter. There are two control codes available to be used in this line: %1 = Filenames %2 = Download limits in bytes If you need to give up the filenames, you can use the %1. If the protocol also accepts the downloadlimit than you can use the %2 in the command line of the protocol. Use the complete pathname for calling the protocol. Options......: Protocol commandline Command......: Upload command Description..: Same as download command, but now for the up- load. Here are also two control codes avail- able. Please note the difference: %1 = Filename or path %2 = Download limits in bytes Use the complete pathname for calling the pro- tocol. Options......: Protocol commandline Command......: Log file name Description..: Name and path of the logfile the protocol cre- ates. Please supply a valid path. This command is used so SuperBBS knows that there has been an upload and it will read the filenames from it. Options......: Path\Filename -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 033 Command......: Control file name Description..: Name and path of the control file SuperBBS creates. This list contains the files to up- /download and should be supplied on the up- /download commandline. Options......: Path\Filename Command......: Efficiency Description..: Efficiency of the protocol in percentage. This is normally somewhere between 95 and 98 per- cent. SuperBBS uses this to calculate the amount of time needed to download the file. Options......: Percentage Command......: Download control string Description..: Format of each file entry in the control file specified above for downloads. One control code is available: %1 = Filename Normally this only contains %1. Please note that this option is not used if you selected the Bimodem protocol type. Options......: %1 Command......: Upload control string Description..: Format of each file entry in the control file specified above for uploads. One control char- acter is available: %1 = Filename Please note this option is not used when you selected a Bimodem protocol type. Options......: %1 Command......: Download logfile keyword Description..: Keyword which will be used in the logfile to note the download. Please note this option is only used if the logstyle type is set to Other. This option is not used when you selected the Bimodem protocol type. Options......: String Command......: Upload logfile keyword Description..: Same as for the download, except now for up- loads. The same exception rules apply. Options......: String -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 034 Command......: File name word number Description..: Please note this option is only used when you select a logfile type as other. This option is not used in the Bimodem protocol type. Options......: Number With these options it is possible to setup 20 external proto- cols. The internal protocols can all be toggled on or off. Bob Henderson wrote an excellent manual on external protocol support for SuperBBS. Please read this if you need more infor- mation on setting up external protocols. The file is called PROTOHLP.xxx (where xxx is the archive type.) Bob's fidonet address is 1:3812/10. The file is also available from 2:500/239 or 42:1100/101 (between 00:00 and 18:00 GMT-1). Here's an example of an Puma/MPT setup: Activated...........: Yes Name................: Puma Key.................: P Batch...............: Yes Protocol type.......: Other Log style...........: DSZ Download command....: c:\prot\puma.exe P*P E*B S9600 Lc:\prot\dsz.log S @c:\files.txt Upload command......: c:\prot\puma.exe P*P E*B S9600 Lc:\prot\dsz.log R Log file name.......: c:\prot\dsz.log Control file name...: c:\files.txt Effic...............: 98 Download cntrl str..: %1 Upload cntrl str....: %1 Download log keyw...: Upload log keyw.....: File name word nr...: 0 The S9600 is used when your COM port is locked at 9600 Bps. Please see Bob's document for more information on the external protocols. He gives a wide variety of examples, ranging from DSZ to Bimodem and HSLink. This should help you get on your way. Refer to the SuperBBS echomail areas if you have trouble setting up a protocol. These areas can be found on most registered SuperBBS systems. The Bimodem protocol is only available with the normal down- load menu option. Other external protocols are available also at the download of the BBSList and Hot-key download command. You don't want your user's to start an upload while down- loading the BBSList file, do you? -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 035 2.5.5 Modem -------------------------------------------------------------- Here you must specify how your modem is setup if your not using a mailer. SuperBBS is capable of running without any front-end program, although you have to use a batchfile to run it. Please refer to the batchfile examples at the end of the documentation for more info on batchfiles. 2.5.5.1 Initialization -------------------------------------------------------------- Type.........: Initializing tries Description..: Number of times SuperBBS will try to initialize the modem. When the modem will not initialize, SuperBBS will give you a warning message and return to MS-Dos or the batchfile. Options......: Number Type.........: Initializing baudrate Description..: The fastest baudrate your modem supports. If you have a 2400 Bps modem, set this to 2400. You might have to lock the speed between your COM port and your modem at higher speeds and install a NS16550AFN chip, instead of the 16450 chip on your COMMS card. Options......: 300 to 38400 Type.........: Initializing string Description..: String send to the modem to reset the modem and prepare it to receive callers. Check your modem manual for the string used to setup your modem. The pipe symbol | can be used for a carriage return. (Some modems take a ^M as a CR.) Please note that there is no general working init string. This is different per modem. Try contacting a Sysop near you who uses the same modem for an init string. He/she doesn't have to run SuperBBS, but could run RemoteAccess or QuickBBS. Options......: Modem init string Type.........: Initializing response Description..: Answer the modem sends to the program, after the initialization string has been send to the modem. This response tells SuperBBS the modem is ready to receive calls. Options......: Modem response string -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 036 2.5.5.2 General options -------------------------------------------------------------- Type.........: Port Description..: Communication port the modem is connected to. This should be the port your modem is setup at, when you have an internal modem or the COM port the modem is connected to with an external modem. Options......: 1, 2, 3 or 4 Type.........: To wait for carrier Description..: Time SuperBBS waits for a carrier signal, before resetting. Options......: Seconds Type.........: Offhook string Description..: String send to the modem when you want to place the modem in 'offhook' mode. This means the callers will receive a busy signal. Please note that in some countries it is illegal to switch a modem offhook. Options......: Modem offhook string Type.........: Offhook response Description..: Answer the modem sends to the program, after the offhook string has been send to the modem. Options......: Modem offhook response string Type.........: xxxx BPS Connect (xxxx = 300 to 38400) Description..: Response from the modem after it has detected a caller and established a connection. This tells SuperBBS at what baudrate the user is calling. Check your modem manual for more information. Users of modems with MNP or V.42bis errorcor- rection protocols should use the normal connect strings for the reliable connections. Please note that SuperBBS now also supports the 7200, 12000 and 14400 modem strings. Options......: Modem response 2.5.6 Other -------------------------------------------------------------- In this part of the configuration you will find some general options concerning New users, restrictions, Alt keys and others. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 037 2.5.6.1 New users -------------------------------------------------------------- A caller who has never been on your system has to be assigned a special userlevel. This could be a normal level, which you are using for all users or, like most BBS systems do, a lower level, so you, the Sysop, can check his/her information. You will have to specify a userlevel and also the flagsetting. SuperBBS uses a double security system. All users, including the Sysop(s) have a security level. Besides that security level there are also 32 flags available. These flags can be toggled on or off. (X = On / - = Off) With these flags you could restrict people with a same userlevel from using the same options. Here is an example: User 1: User 2: Userlevel: 25 Userlevel: 100 Flag A: X------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: -------- Flag D: -------- Flag D: --XX---- Menu option A: Menu option B: Level needed: 25 Level needed: 25 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: -------- Flag C: -------- Flag D: -------- Flag D: --XX---- Menu option C: Menu option D: Level needed: 10 Level needed: 100 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: --XX---- Flag D: -------- Flag D: -------- User 1 would be able to use menu options A and C. The user has no access to menu option B or D, because in option B his flagsetting is not correct and in option D his userlevel is not high enough, although the flagsetting is correct. User 2 has access to menu option A and B. The user has no access to menu C because of the flagsetting, although his level is high enough, and the access to option D is denied because of the wrong flagsetting. You see how powerful this safety system can be. Use it with care, specially when you are setting up a BBS for the first time. Check your menu's with all available options, so you won't run in to a nasty surprise, like a user getting to a special Sysop menu. (SuperBBS also has the ability to protect menus with passwords. More of this in the menu commands.) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 038 Type.........: New user security level Description..: Level assigned to a new user when he/she enters the BBS for the first time. Options......: Userlevel Type.........: New user flags (A to D) Description..: Flagsetting assigned to a new user when enter- ing the BBS system for the first time. Options......: Flagsetting (X = On / - = Off) Type.........: Ask voice phonenumber Description..: Toggle the voice phonenumber question on or off at logon for a new user. Options......: Yes/No Type.........: Ask data phonenumber Description..: Toggle the data phonenumber question on or off at logon for a new user. Type.........: Ask birthday Description..: Toggle the birthday question on or off at logon for a new user. Options......: Yes/No Type.........: Use aliases Description..: Toggle the use of aliases on or off for use in the bulletin board system. Options......: Yes/No Type.........: Ask sex Description..: Toggle the Male/Female question on or off at logon for a new user. Options......: Yes/No Type.........: ANSI graphics Description..: Toggle the ANSI graphics question on or off at logon for a new user. Options......: Ask/No Type.........: Mail check Description..: Toggle the mail check at logon question on or off at logon for a new user. Options......: Ask/No Type.........: New files check Description..: Toggle the new files check at logon question on or off at logon for a new user. Options......: Ask/No Type.........: Full screen editor Description..: Toggle the full screen editor question on or off at logon for a new user. Options......: Ask/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 039 Type.........: Full screen viewer Description..: Toggle the full screen viewer question on or off at logon for a new user. Options......: Ask/No Type.........: More prompt Description..: Toggle the more prompt question on or off at logon for a new user. Options......: Ask/No Type.........: Screen clears Description..: Toggle the screen clear question on or off at logon for a new user. Options......: Ask/No Type.........: Combined board settings Description..: SuperBBS will ask the new user at logon which areas he/she would like to read. This allows you to let your users decide which areas they read if they have access to the area. If switched off, all areas will be available to which the user has access. Options......: Ask/No Type.........: Combined mail check Description..: Normally SuperBBS will check all message areas for new mail for the user. If you set this option to yes, SuperBBS will only scan for new messages in the areas the user selected (and has access to). You can force an area to be included in the new mail scan through the area setup. Options......: Ask/No Type.........: Ask default protocol Description..: SuperBBS allows the users to select a default protocol, which will be used for every file transfer. (The user can also select not to use a default protocol.) If you don't want to use default protocols for your users, set this option to no. Options......: Ask/No Type.........: Hotkeys Description..: SuperBBS normally uses hotkeys, that means that you don't have to press ENTER after every com- mand. You can however switch this setting off, or let your users decide. When not selected, a user will have to press ENTER after a command is given. Options......: Yes/Ask/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 040 Type.........: Days until expiration Description..: Number of days added to the expiration counter for the new user. This way you could automati- cally add a certain number of days to the record of the new user. SuperBBS will decrease this field every day with one, until it is zero. Than the questionnaire EXPIRED.Q-A is activated when the user logs on. Options......: Number of days 2.5.6.2 General options -------------------------------------------------------------- The general options in SuperBBS contain information about how SuperBBS reacts to certain things, like inactivity time outs, logons with wrong passwords and a whole range of other options. Type.........: Inactivity time (Seconds) Description..: Time in seconds before SuperBBS will disconnect a user if no key is pressed in the specified time period. This option prevents users from keeping the system busy, while they are doing something else. SuperBBS will display a warning 20 seconds before disconnecting. Options......: Time in seconds Type.........: Maximum logon times (Minutes) Description..: Time limit given to new users to logon to your system. Depending on the size of your question- naire, you should set this to a safe amount, otherwise your user will be logged off when in the middle of answering the questions. Options......: Time in minutes Type.........: Menu border colour (0-7) Description..: Colour of all the menu borders hardcoded into SuperBBS. Available colours are: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey The colour blue (1) will be displayed as an underlining on monochrome Hercules monitors. This could cause you menus to look weird, so don't use blue if you don't need it. Options......: Colour number -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 041 Type.........: Entry field colour (0-7) Description..: Colour of the background when SuperBBS asks the user for input. (For available colours see the menu border option.) Please use this option with care. On VGA monitors some colour combina- tions are not as visible as they could be. (For example yellow text on a green background.) Options......: Colour number Type.........: Maximum password tries Description..: Maximum number of times the user can try to get the right password to logon to the BBS, before being forced off-line. If enabled, SuperBBS will ask the user if he/she wants to leave a message to the Sysop. Don't set this number to high. Options......: Number of attempts Please note that SuperBBS will not ask for a password if there is no password supplied in the userfile. This can only be achieved through the use of the Sbbsuser.exe program. (When an user logs on to your system, he/she has to provide a password of at least 4 characters.) You could use this option to pro- vide 'guest' access to your system. Use this option with care! Type.........: Maximum pages per call Description..: Maximum number of times the user can yell for the Sysop per call. If the user tries another time, a message will be displayed. Options......: Number of pages Type.........: Page bell length (Seconds) Description..: Number of seconds the page melody will be played when the user tries to page the Sysop. This will only be heard at the Sysop machine. If you don't use Yellcfg.exe, this will be a 'fiuus' siren like sound. Options......: Time in seconds Type.........: Sysop security level Description..: Security level used by the System Operator of the BBS, mostly you! Options......: Security level -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 042 Type.........: Entry colour (0-15) Description..: Type of colour used to display the users answers in the entry fields. The entry fields will have the background colour supplied at the entry field colour option above. Do not use 0, as this would be black and the user could not read his/her answer. Available colours: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White Remember that blue gives an underlining on monochrome Hercules monitors. Options......: Colour number Type.........: Maximum minutes in bank Description..: Maximum amount of time in minutes a user can store in the build in time bank. Options......: Number of minutes Type.........: Age graph starting age Description..: When displaying the build in age graph, you can set the starting age. You can also let your users select the age to start the graph. Options......: Age Type.........: Seconds before screen blank Description..: This option is only used when running SuperBBS without a mailer. It is the time between start- ing SuperBBS and the time the screen will go blank to prevent burning in your screen. Options......: Seconds -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 043 Type.........: Redirect device Description..: Device which will be used to redirect communi- cation when using, for example, the Tempdir option. The 'Gateway' driver, which is to be found on most BBS's, is perfect for this. If you don't have a gateway driver, use COMn. (n = your COM port number) The redirection will make sure that everything displayed on your local screen is also visible on the remote screen and that the remote keyboard will work as an input device. The Gateway driver will allow you the use of both the local and remote monitor and keyboard. Options......: COMn or Gateway driver Type.........: First menu in system Description..: Normally you start your system with the TOP.MNU menu. If you want your system to start with an other menu, instead of the TOP.MNU menu, you can enter the name here. SuperBBS will then start at the given menu. If left empty, Super- BBS will start at the TOP.MNU menu. Please note that the load menu option in the SBBSUSER.EXE program overrides this option. Options......: Menu name Type.........: ANSI at logon Description..: If you have ANSI menu's and screens available, SuperBBS can ask at logon to display the ANSI version of the logon sequence, instead of the ASCII sequence. Also available at this option is the detection of ANSI. SuperBBS will know if the user is using ANSI or not. If not, SuperBBS will display the ASCII logon, otherwise the ANSI logon is displayed. With this option it is possible to have ANSI off and still use the full-screen editor. (Which normally only works if the user has ANSI enabled.) If the user has the FS editor switched on, ANSI switched off and he/she wants to write a message, SuperBBS will use the FS editor if it detected the user has ANSI available. This will only work if you have switched this option to 'Detect'. Options......: Yes/No/Detect -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 044 Type.........: Phonenumber scanning mode Description..: SuperBBS can compare a newly entered phone number with the already available phonenumbers of the other users and respond to duplicate numbers. You have three options here: - No scanning - Scan and system.log entry - Scan, system.log entry and disconnect SuperBBS will not check for double phonenumbers if you set this function off. If only the sys- tem.log entry is enabled, SuperBBS will write an entry in the logfile telling you the user used an already available phonenumber. The third option does the same, but goes one step further. SuperBBS will display the ANSI/ASCII file DPHONE.A?? and then disconnect the user. Options......: No scan/System.log/Disconnect 2.5.6.3 On/Off settings -------------------------------------------------------------- Type.........: Output ^E character Description..: The ^E or ENQ character is used by some com- munications programs to determine the begin of a session. For example Telix's Salt language can react to it. Options......: Yes/No Type.........: Use direct screen writes Description..: Allows SuperBBS to write directly (=fast) to the screen, instead of using the BIOS routines. Some CGA monitors with 'snow' need this option off. Also some multitaskers prefer BIOS screen writes. Options......: Yes/No Type.........: Snow checking Description..: Allows you to check for 'snow' on your monitor. This normally only the case with old CGA moni- tors. Options......: Yes/No Type.........: Allow Sysop remote Description..: When activated, the Sysop is able to logon from remote, ie. through the use of a modem. If disabled, the Sysop, as specified in the regis- tration part of the configuration, will not be able to logon remote. This is an extra safety feature to prevent users using your name. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 045 Type.........: Logon password to Sysop Description..: If enabled, this option will show the password from the user logging on to your system at the bottom of the local screen to the Sysop. This will only be visible at the Sysop side. Options......: Yes/No Type.........: Use 7bit characters Description..: If enabled, this option allows only the use of 7bit characters in the echomail areas. Options......: Yes/No Type.........: Run system in mono mode Description..: If you're using a monochrome monitor on your system, you could set this option to 'Yes'. This only affects your side of the system, users will see all available colours when run- ning ANSI graphics. Some doors will react to this option. Options......: Yes/No Type.........: Logout temp dir clean Description..: This option enables SuperBBS to clean the tem- porary directory after the user logged off. This will prevent files being left in the tem- porary directory. Options......: Yes/No Type.........: Allow one word names Description..: If this option is enabled, users will only have to give one name to logon to the system. It will allow more than one name, but SuperBBS will only scan for the first part of the name. If not enabled, the user will be asked his first and last name. Names with more than 2 parts, should be separated by a period. For example: John.mike Mac.arthur Options......: Yes/No Type.........: Sysop fast logon Description..: This option allows you, the Sysop, to logon to the BBS quickly by only giving a password. SuperBBS will presume the Sysop is the user on- line. Don't use this option if you have more than one person login on to your system locally. Options......: Yes/No Type.........: Exclude Sysop Description..: If you don't want your (Sysop)name to be dis- played in the lists SuperBBS generates, like last 15 callers and userlist, switch this off. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 046 Type.........: Alt-J swapping Description..: SuperBBS has the option to swap itself to EMS memory or disk when you jump to Dos. (Alt-J). This will leave only 4 Kbyte of SuperBBS in the memory resident, allowing to run some other program while shelled to dos. Options......: Yes/No Type.........: Capitalize city Description..: SuperBBS can capitalize the information in the City field. The first character will be upper case, the others will be lower case. Example: helsinki ----> Helsinki WOERDEN ----> Woerden New York, USA ----> New York, Usa Note that USA or any other abbreviation will also be capitalized. Options......: Yes/No Type.........: Capitalize alias Description..: See capitalize city, except this time it works on the alias field of the userrecord. Options......: Yes/No Type.........: Crtl-X in pictures Description..: SuperBBS allows you to run external programs from a textfiles. You will have to set the commandline in the file as follows: <Ctrl-X>Myprog.exe *F *L| When a user displays the textfile, SuperBBS will notice the Ctrl-X and executes the program behind it. The pipe symbol means ENTER. If you don't use Ctrl-X codes, leave this option dis- abled. Options......: Yes/No Type.........: Alias search at logon Description..: It is now possible to logon with your alias name if the Sysop enables this option. You will still be asked for a password. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 047 Type.........: US Phonenumber format Description..: For those who are working with the American phone format, SuperBBS now allows you to use the (XXX)XXX-XXXX format for your phonenumbers. If your not using the USA format, leave this option off. Note that always the full voice and data phone numbers are required when using the US phone format. Options......: Yes/No Type.........: Allow IEMSI logins Description..: SuperBBS allows automatic logins to your system through the use of IEMSI. IEMSI is a standard set in the FSC-56 (or EMSC-001) proposals. Some programs, like Frontdoor Terminal, support this concept. It allows you to specify your profile, like name, password, ANSI, CLS, More, New files, Message scan and other options. When calling a BBS system which has IEMSI available, the login will be done automatically. No script file is needed. If the BBS uses Frontdoor as a mailer, the 'Press 2x ESC' bit is also done by IEMSI. Options......: Yes/No Type.........: Random birthday verify Description..: To obtain a better system security, SuperBBS allows you to switch on a birthday verification option. If enabled, SuperBBS will at every login, even the local ones, take a random num- ber between 1 and 5. If this number is 1, the user will be asked for his/her birthday. If entered correctly the user can go on, if not correct, the user will be disconnected. The ANSI/ASCII file BVERIFY.A?? is displayed before the verification. Options......: Yes/No Type.........: Create DORINFO?.DEF Description..: SuperBBS can now create a DORINFO?.DEF file for every node. Instead of the normal DORINFO1.DEF file, the DORINFO?.DEF file will have the node- number in place of the '?' sign. Like for node 4 it would be DORINFO4.DEF. Options......: Yes/No Type.........: Extended node info Description..: SuperBBS can now display in the online menutype that a node is 'Down' or 'Waiting for call'. You have to change this with SBBSUTIL.EXE in your batchfile. This option allows you to turn that info on or off. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 048 Type.........: Local Attach (LA) check at logon Description..: Tells SuperBBS to scan for local attach files at logon or not to scan for them. Options......: Yes/No Type.........: Only 7bit characters Description..: Use only 7bit characters, do not allow the use of 8bit characters. Options......: Yes/No Type.........: Page reason to subject Description..: Use the page reason on the subject line of the message the user can leave behind if you, the Sysop, didn't answer the page. Options......: Yes/No Type.........: Auto chat capture file Description..: SuperBBS now has the option to automatically log the chat you have with a user, so you will be able to read back what you have typed. You can also turn on the log function manually from the keyboard, while in the chat. Options......: Yes/No Type.........: Free Local Attach (LA) downloads Description..: Local attach files, files send from you to another user, can be free for the user to down- load if you enable this option. If not enabled, the users download/time restrictions are checked before the user can download the file. Options......: Yes/No Type.........: NEWS.A?? date check Description..: When a user logs on to your system, he/she will get to see the NEWS.A?? file, even when this file has not been updated since his/her last visit (or longer). Now you can enable the option to only show the news file when the file has changed since the user viewed it for the last time. This will speed up the login on your system. You can still build a menu option to view the newsfile from within the BBS. Options......: Yes/No Type.........: Use NAMEIDX.BBS file Description..: This is a new user indexfile for SuperBBS. This will speed up userfile searches. Disable this option only if you have some trouble with the NAMEIDX.BBS search facilities. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 049 Please note that if you use a program which is not NAMEIDX.BBS aware to sort, pack or edit your userfile, you should run USERPACK.EXE every time you use that program. This is manda- tory, or you might run into problems! 2.5.6.4 Restrictions -------------------------------------------------------------- Here you specify the Bps rates needed to logon to the system, time of the day downloading and paging the Sysop is permitted and 300 Bps usage. Type.........: Min. Bps rate to logon Description..: This will prevent users with a Bps rate lower than the one specified to gain access to your system. Options......: Bps rate Type.........: Min. Bps rate to allow ANSI Description..: Minimum Bps rate a user must have, before he/she can use the ANSI menus and textfiles. Options......: Bps rate Type.........: Min. Bps rate to file transfers Description..: Minimum Bps rate a user must have before he/she can transfer files. Options......: Bps rate Type.........: Min. Bps rate for Full Screen chat Description..: Minimum Bps rate of a user to be able to use the full screen chat. Options......: Bps rate Type.........: 300 Baud usage time window Description..: SuperBBS allows you to keep 300 Bps users from your system at certain hours. A message will be displayed if the user is too slow for the BBS. Options......: Start and end time (24 hour format) Type.........: Downloading time window Description..: Time period in which file transfers are allowed. A message will be displayed if a user tries to do a file transfer outside these hours. Options......: Start and end time (24 hour format) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 050 Type.........: Min. security to logon Description..: If the user has a lower security level than specified here, he/she will be logged off after the file LOGONSEC.A?? is displayed. This way you could run a second line for known users only or just allow members on the BBS. If left blank this option is disabled. Options......: Security level or None Type.........: Min. age to logon Description..: If the users age is lower than the age set in this option, the user will be logged off after SuperBBS displayed the LOGONAGE.A?? screen to the user. If left blank this option is dis- abled. Options......: User age or None Type.........: Password to logon Description..: The user is asked for the password given in this option if he/she wants to logon to the system. If the user enters a wrong password SuperBBS will display the file LOGONPWD.A?? and then disconnects the user. If left blank, this option is disabled. Note that the password given here is a 'global' password. the user still has to enter his/her own password to get into the system. Options......: Password or None Type.........: Sysop paging time Sunday (to Saturday) Description..: Time period in which it is possible to page the Sysop. If a user pages outside these hours, a message will be displayed. You can set the paging hours for every day of the week. Options......: Start and end time (24 hour format) Type.........: Logon flags Description..: Flagsettings needed to enter the BBS. If the user doesn't have the correct flagsettings, he/she will see the file LOGONFLA.A?? and will then be disconnected. Options......: Flagsetting 2.5.6.5 Alt-F keys -------------------------------------------------------------- From within the SuperBBS program, you have access to 10 programmable keys, Alt-F1 to Alt-F10, for your own programs. These keys are only available to the local system, a remote user can not access the Alt FKeys. An example: Alt-F1: C:\SUPERBBS\SBBSUSER.EXE *S -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 051 The *S tells SuperBBS to swap itself out to EMS or disk, before executing the requested program. All ten keys are available for your own use. 2.5.6.6 String configuration -------------------------------------------------------------- This part of the configuration program allows you to define some of the strings used in the SuperBBS program. These strings will be shown to your users if needed. Please note that these strings are used for all languages and every user. Make sure everybody can understand them. More strings of SuperBBS can be configured through the use of the Lconfig program described later. The Lconfig program will allow you to run a multi lingual system. Type.........: Loading prompt Description..: Shown to your users at a type 7 or 15 exit from SuperBBS, when executing an external program. (See the menu part of the docs for more infor- mation about those menu options.) Options......: String Type.........: Selection menu prompt Description..: Shown to your users after displaying the index file from a selection menu. This prompt should include the following options: [ENTER] To return from the selection menu to the main BBS. [1...9] Options available. This depends on the amount of options avail- able in the selection menu. Cur- rently 9 is the maximum. The L for list is not needed, because SuperBBS will automatically display the index file after a user has viewed an available selection. For more information about the selection menu, check out the menu part of the documentation. Options......: String -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 052 Type.........: Origin line Description..: This string will be added to every echomail message send from your system. The maximum length for this string is 80 characters, in- cluding your address defined in the netmail part of the config program and '* Origin: ' which is put in front of your origin line by SuperBBS. You are not allowed to use extended ASCII or ANSI codes in this line. It is useful to include your phone number so people know how to find you when reading messages originating from your board. You can select a different origin for every area in the area setup part of the configuration. If none is given the default origin specified here will be used. Options......: String Type.........: F8 status line 1 Description..: SuperBBS shows the Sysop a lot of information on the two bottom lines of the screen while a user is online. Now you can define the text displayed for the F8 function key. You can use all available control codes in the line. Please note that the line cannot exceed the 80 charac- ters including the (expanded) control charac- ters. Options......: Status line Type.........: F8 status line 2 Description..: SuperBBS shows the Sysop a lot of information on the two bottom lines of the screen while a user is online. Now you can define the text displayed for the F8 function key. You can use all available control codes in the line. Please note that the line cannot exceed the 80 charac- ters including the (expanded) control charac- ters. Options......: Status line Type.........: Replying to message Description..: When replying to a message, it is possible to put a line at the top of the message stating some information, like who wrote the original message and on what date. Here you can specify the text you want to appear on that line. There are two control codes available: %1 is replaced by the name of the writer of the original message %2 is replaced by the date of the orig- inal message Options......: Textline -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 053 2.5.6.7 Door configuration -------------------------------------------------------------- SuperBBS is the first BBS program to support menu templating for doors. This means you can use one menu for all your doors. You can configure up to 200 different doors. Instead of setting up all doors separately in your menus, you now use control codes, which are replaced by the information given in the configuration menu of the doors. The following options are available in this part of the con- figuration program: [PgDn] Move to next area [PgUp] Move to previous area [F1] Add door [F2] Delete door [F3] Jump to door Pressing [ESC] will get you back to the main configuration menu and save the door information. You will have to provide the following information: Type.........: Door name Description..: Name of the doorgame. This will be displayed in the door select menu and by using the control codes. Options......: Menu name Type.........: Command line Description..: The commandline to start the door. here you can use all options available to type 7 exits. (See menu types for more information.) If you want to use a type 15 exit, you will have to use a '?' as the first character on the commandline, followed by the errorlevel. Example: ?115. This will exit to your batchfile with errorlevel 115. (An example will follow below.) Options......: Commandline or Errorlevel (?xxx) Type.........: Security level Description..: Security level needed to access the door. With- out the correct security level the door won't be displayed in the list of available doors. Options......: Security level -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 054 Type.........: Flags A to D Description..: Flagsetting needed to access the door. Without the correct flagsetting the door won't be dis- played in the list of available doors. Options......: Flagsetting (X = On/- = Off) Type.........: Start time Description..: Starting time for the door to be available to the users. This has to be in 24 hour format. Options......: Time (24 hour format) Type.........: End time Description..: Ending time of the availability if the door. With the starting time you can have opening and closing hours on your doors. Options......: Time (24 hour format) Type.........: Active Description..: If this option is turned off, the door will never show up in the doorlist. If enabled the door is accessible for the users (if the time settings allow it). Options......: Yes/No Here's an example of how to setup a door. Used here is the Pong doorgame from Livesystems (TM): Name: Pong Commandline: \doors\pong.exe -T:*T -NOS -BALLS:4 Security: 10 Flag A: ---X---- Flag B: -------- Flag C: -------- Flag D: -------X Start time: 10:00 End time: 22:00 Active: Yes This setting will only allow users in the door with a security level of 10, flags A4 and D8 set to On. And the user has to call between 10:00 (10 am) and 22:00 (10 pm) hours. Menu commands 86 and 87 are used for accessing the doors. See the menu part of the configuration for more information. Two control codes have been added to display the doorname and number. These are: <Ctrl-K>& Name of the current door <Ctrl-K>/ Number of the current door -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 055 A control code is used to specify the current door in the optional data field. This code is: @D Number of the door You can use this code to display a different file for every door, by using it in the optional data field like this: Menu type: 5 Optional data: DOOR@D If you are at door number 3, the file DOOR3.A?? will be dis- played. If your at door number 198, file DOOR198.A?? will be displayed. This is just one example of how to use the control code. 2.5.6.8 Multi node configuration -------------------------------------------------------------- The multiline options are available for running a multiline system. SuperBBS is designed to run multiline. You have to fill in the following options, even if you run a single line system. Type.........: Lines in system Description..: Number of lines you are running. If you run a single line system, enter 1. Otherwise enter the number of lines, including local lines. Make sure you set this to the same amount for every line. Options......: Number of lines Type.........: Common path Description..: Drive and directory which will be used by all lines available as a common directory. A RAM disk of 30 to 50 Kbytes is recommended. A nor- mal disc can also be used if a RAM disc is not available. SuperBBS will store information like who is online in this directory. Options......: Drive:\Pathname 2.5.6.9 Event editor -------------------------------------------------------------- SuperBBS allows you to setup 30 events, which will be executed at the set time and weekday(s). This allows you to run main- tenance, clean up actions and other activities at quiet moments. You have to setup SuperBBS with a batchfile and errorlevels if you want to use this option. Otherwise SuperBBS will exit at the given time and weekday, but will never return. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 056 Moving around the fields with the cursor keys. [PgUp] and [PgDn] will switch between the events. [F1] will jump to a certain asked for event number. Type.........: Status (O = Deleted/1 = Enabled) Description..: Controls wether the event is active or not. The 1 means active, the 0 means inactive. Options......: 0 or 1 Type.........: Runtime Description..: Time the event has to be executed in 24 hours format. Options......: Time Type.........: Errorlevel Description..: Errorlevel SuperBBS exits with at the time of the event. This allows you to start an external program from your batchfile. Do not use error- levels between 0 and 10, because these have special meanings for SuperBBS. Consult your DOS manual if you are unfamiliar with the use of errorlevels. Errorlevels may range from 0 to 255. Options......: Errorlevel Type.........: Forced Description..: If an event is scheduled, but a user is on-line at the given time, the event will be overdue and not be executed. When you force an event to be executed, SuperBBS will reduce the time of the caller online, so he/she is logged of just before the event starts. A warning message will be displayed to the user, telling him/her the time is adjusted. SuperBBS will not allow callers online within five minutes before the event. Options......: Yes/No Type.........: Days to run the event Description..: This tells SuperBBS on what day(s) the event has to be executed. (Sunday to Saturday). mark the days you want to run the event with 'X'. Options......: X -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 057 2.5.6.10 Keyboard password -------------------------------------------------------------- As a security feature, SuperBBS has now the option to lock the keyboard. Before you will be able to enter anything at the local console, you will have to enter the specified password. Access will be denied if the password is not correct. This option works on all Sysop keys and before you enter the con- figuration program, so don't lose the password code if you entered one. 2.5.7 Colours -------------------------------------------------------------- This part of the configuration allows you to change the col- ours used within SuperBBS. (There are three pages available.) Your users will be able to change them personally, but this option allows you to set the 'Standard' colours. You will be presented with a view of the current colours. Press the number corresponding with the number you want to change and use the cursor control keys to change the colour. The following keys are active in these menus: [ESC] Exits to main menu. [D] Sets colours to default values. [0-9] Available options keys. [Cursor] Change colour. The user can set the colours to his/her own liking with the available menu option. These settings are however your 'standard' settings for all users. Note that option 1, 2 and 3 on the colour configuration page 2 are for the door select command and the message and file area select command. The following colours are available: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue (Continued on next page) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 058 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White Please note that the colour blue will be represented on mono- chrome HGC systems as a highlighted underlined colour. This can give strange effects on these screen when viewing your menus. Background colours may give unsatisfied results when used in conjunction with CLS codes. (The page might be cleared with the specified background colour.) 2.5.8 Limits -------------------------------------------------------------- The LIMITS.BBS file contains all information about security levels and flagsettings for all users.This file is the control centre for the time allowed online, download limits, ratio checks and call allowed per day. This file is not an ASCII file and can only be edited through the configuration program. Security levels can range from 0 to 32000, where 0 is the lowest available level and 32000 the highest. Take a little time to think about how many levels you will need and if you need any flagsettings.The flagsettings are an easy way to give somebody access to an area, while others with the same or higher level don't have access to. Remember that even the Sysop has no access if his/her flagsettings are not right. If you enter the Limits editor, you'll be presented with a small window. Here you can add, delete and change the user- levels. The following keys are active: [ENTER] Choose the marked level for editing. [INSERT] Add a new user level. [DELETE] Remove a userlevel. [F1] Converts LIMITS.CTL to LIMITS.BBS. [ESC] Return to main configuration menu. [CURSOR] Move around the available levels. When choosing a level, you will be presented with a second window, where you can edit the options. SuperBBS will sort the userlevels from small to big in the main window, so don't worry if you want to insert a level somewhere. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 059 Type.........: Security level Description..: Current security level. this can not be edited in the edit window. Only in the main window can you add or delete security levels. Options......: None Type.........: Download limits per Bps rate Description..: Number of Kbytes a user can download per day. The values depend on the speed. If a user exceeds this limits, he/she will see a warning. Options......: Amount in Kbytes Type.........: Time limit (in minutes) Description..: Maximum time allowed per day. The user will see a message if his/her time is used up for the day. He/she has to wait till the next day, before he/she is granted access again. Option.......: Time in minutes Type.........: Calls allowed per day Description..: Besides the time limit, you can also setup a limit of calls per day. If a user calls more than the set amount, he/she will see a message and will be disconnected. Option.......: Number of calls Type.........: Download/Upload ratio in Kbytes Description..: The users download/upload ratio in Kbytes. This means that if a caller downloaded xx Kbytes, he/she has to upload yy Kbytes before another download can be performed. Setting this to 0 disables the option. Options......: Kbytes Type.........: Download/Upload ratio in files Description..: The users download/upload ratio in files. this means that a user who downloaded xx files has to upload a file, before he/she can download again. If you set this to 5, every user has to upload 1 file to download 5. Setting this to 0 disables the option. Options......: Number of files Type.........: Description Description..: Description for the current user level. This can be used in your textfiles through the use of a control code. You can display the descrip- tion to the user by using a control code. Please note that this description is the same for all languages. Options......: Name -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 060 Pressing [ESC] will bring you back to the main Limits window and save the changes. Pressing [ESC] again will bring you back to the main configuration menu. 2.5.9 Paths -------------------------------------------------------------- This part is important. Making mistakes here could cause SuperBBS not to run. Make sure all paths are correct. A back- lash at the end of a directory path is optional. Type.........: Text path Description..: Drive and directory where your supporting ASCII and ANSI textfiles will be stored. In the LCONFIG.EXE program are the path statements also included. If SuperBBS can't find the wanted file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Menu path Description..: Drive and directory where your menu files are stored. In the language file you also have to specify the directory for the menu files. If SuperBBS can't find the wanted menu file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Net path Description..: Drive and directory where your netmail is stored. Some mailer systems can handle *.MSG netmail messages and they need this directory. If you use D'Bridge (TM) and SuperBBS with the netmail area setup as a QuickBBS (TM) type mail area, you have to point this directory to an existing directory, although the option is not used with this configuration. Options......: Drive:\Pathname Type.........: Message base path Description..: Drive and directory where your message base files (MSG*.BBS) are stored. This can be the main SuperBBS directory, or another directory. Point this to the same directory for every line you run in a multinode system. Please note that some echomail processors require the message base files in the main BBS directory. All the MSG*.BBS files will be created the first time you run SuperBBS. Options......: Drive:\Pathname -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 061 Type.........: Temporary path Description..: Drive and directory where SuperBBS will place temporary files, created when using the archive extract, view and repack option. A multi-node system will need a directory for every node. Options......: Drive:\Pathname Type.........: System path Description..: Drive and directory where your main BBS files will be placed. This is the directory you run the configuration program from. Here all system files will be placed. Options......: Drive:\Pathname Type.........: Work path Description..: Drive and directory where SuperBBS will place files it has to work with. Files uploaded to your BBS can be checked for viruses in this directory. Create a directory for every node you are running. Options......: Drive:\Pathname Type.........: External editor Description..: Drive, directory and filename of the external editor you want to use in the BBS. The most used editor is Quicked. Leave this page blank if you don't have a full-screen editor. Super- BBS now writes DORINFO?.DEF and EXITINFO.BBS before shelling to the editor. This allows you to use the *S command, to tell SuperBBS to shell to EMS/DISK before calling the editor. Option.......: Drive:\Pathname\Filename.ext Type.........: Virus scanner Description..: The viruschecking program is now configurable. You can use four optional parameters in the virusscanner commandline. These are: %1 Is replaced by the complete filename to scan. Example: C:\WORK1\SBBS_115.ZIP %2 Is replaced by the filename without the directory. Example: SBBS_115.ZIP %3 Is replaced by the extension only. Example: .ZIP %4 Is replaced by the directory only. Example: C:\WORK1\ All menu type 7 parameters (see menu types for these parameters) are available for your use. If this line is left empt, SuperBBS will use McAfee's Scan (TM) for scanning viruses. You can also specify if the file has to be -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 062 extracted before the virusscan and with what errorlevel to exit when a virus is found. (These are set in other parts of the configur- ation program.) Option.......: None or virusscanner and options Type.........: Nodelist path Description..: SuperBBS has (limited) nodelist support. You will need to specify where your nodelist is located. This nodelist has to be compiled with the external SuperBBS program SBBSNODE.EXE. (See external programs for more information on this utility.) SuperBBS uses the real Nodelist and can use up to 10 private nodelists. Nodelist support is limited, because the costs field is not supported yet. This will change in a future release. SuperBBS also supports Point numbers now in netmail addresses. SuperBBS will also work without the nodelist files without any problem. Point addresses are still sup- ported. Options......: Path to Nodelist and index files Type.........: Local Attach (LA) path Description..: Your users can now send files to each other. Local Attach files is achieved through menu option 90. the files are stored in the direc- tory specified here. See the chapter on files for more information. Options......: LA directory Type.........: Boards.bbs Description..: SuperBBS uses a file called BOARDS.BBS to spec- ify the message areas. You can either select to have this file for every node you are running, or as a separate file per node. Before running SuperBBS 1.16, you will have to run the program 115TO116.EXE. Another program, BOARD2CF.EXE, is provided to store the information from the BOARDS.BBS file in the CONFIG.BBS, for exter- nal, non SuperBBS, utilities who need the mess- age area information in the configuration file, instead of the new BOARDS.BBS file. (See also the part of this documentation on the message areas.) Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 063 2.5.10 Quit -------------------------------------------------------------- This option exits you from the configuration program. Pressing ESCape from the configuration menu has the same effect. You will be asked if you want to save the configuration file or not. 2.6 Environment variable -------------------------------------------------------------- As of version 1.10, SuperBBS needs an environment variable SBBS. This variable needs to be set before starting SuperBBS. Your AUTOEXEC.BAT or SuperBBS batchfile is a good place for it. Setting the variable works like this: SET SBBS=Drive:\Pathname The drive and directory should point to your main SuperBBS directory, where the BBS.EXE file is stored. If you don't know how to make an AUTOEXEC.BAT file, consult your DOS manual. If you get an error like: 'Out of environment space', you will have to enlarge the environment size in your CONFIG.SYS file. See your DOS manual for more information. Setting this variable is needed for single and multi line. As of version 1.16, there is a second variable available. This second one is for the location of the overlay file. It is now possible to store the overlay file on a ramdisk (or any other disk you want to). You will need to set the SBBSOVR variable specifying the location of the overlay file, like this: SET SBBSOVR=Drive:\Pathname If you use a ramdisk to store the overlay file, add -* and -O0 to the commandline of the BBS.EXE program. (See commandline options.) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 064 Chapter 3. Language support ============================================================== 3.1 General information -------------------------------------------------------------- SuperBBS supports the use of many different language files, so you can setup menus and supporting textfiles in your own language or several different ones. The language support is done through the use of the .LNG files. These files are edited with the LCONFIG.EXE program. You can setup different menu and textfiles directories for every language file in use. This way you are able to have all files and menus in the languages you choose to use. Let's have a look at an example: English: Menu path: c:\sbbs\menu-uk Text path: c:\sbbs\text-uk Dutch: Menu path: c:\sbbs\menu-nl Text path: c:\sbbs\text-nl If a user chooses the dutch language file, SuperBBS will look in the directory specified in the dutch .LNG file, i.e. c:\sbbs\text-nl and c:\sbbs\menu-nl for the text and menu files. All systemfiles are in the directory defined in the main configuration program, described in chapter 2. Even if you are using 1 language file, you still have to tell SuperBBS where to look for it's files. The description is shown to users who login for the first time, or want to change their language used. If SuperBBS can't find the specified file in the directory given in the .LNG files, it will look in the directory spec- ified with the SBBS variable. This way you don't need separate language files for every line you run. 3.2 Lconfig.exe -------------------------------------------------------------- You can start the language configuration program in two ways. The normal way is to start the program without any parameters, but you can also enter the filename of the file you want to edit as a parameter. For example: LCONFIG.EXE <Xmit> or LCONGIF.EXE ENGLISH.LNG <Xmit> The second option will load the language file ENGLISH.LNG at startup. The first option will ask you for the file you want to edit and display the directory. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 065 When you start the LCONFIG program, you will be presented with the following menu: 0. Path & description B. Other strings (Page 2) 1. Logon strings (Page 1) C. Other strings (Page 3) 2. Logon strings (Page 2) D. Other strings (Page 4) 3. MsgBase strings (Page 1) E. Status strings 4. MsgBase strings (Page 2) F. Month strings 5. MsgBase strings (Page 3) G. Weekday strings 6. Msg reading command keys H. BBSList strings 7. FileBase strings (Page 1) I. Multiline status str. 8. FileBase strings (Page 2) J. QWK strings 9. FileBase strings (Page 3) ?. A little help A. Other strings (Page 1) Description : Menu path : Text path : Date format : Input date format : Time format : <ESC> to exit Moving around the configuration program is done through the cursor keys. Pressing [ESC] will save the changes and exits the program or, when editing a page, return you to the main configuration menu. Take note of the fact if their is a question mark behind the question or not. Some questions will have a (Y/n)? or (N/y)? option automatically put behind it. 3.2.1 Path & description -------------------------------------------------------------- Here you specify where the language menu and textfiles are stored. Also it is now possible to change the way SuperBBS uses the date and time. You can adjust the time and date the way they are used in your own country or even different for each language you use. Type.........: Description Description..: Name given to the language file. Displayed to new users at logon and users who want to change their language. Example......: English -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 066 Type.........: Menu path Description..: Directory where SuperBBS will look for the menu files belonging to this language file. You can have more than one language file pointing to the same menu directory. The backlash at the end is optional. Example......: c:\superbbs\menu-uk Type.........: Text path Description..: Directory where SuperBBS will look for the text files belonging to this language file. You can have more than one language file pointing to the same directory. The backlash is optional. Example......: c:\superbbs\text-uk Type.........: Date format Description..: Specifies the way SuperBBS uses the date in it's fields. Here are some examples: dd-mmm-yy becomes : 31-Jan-91 mm-dd-yy 01-31-91 dd-MM-yy 31-1-91 If the settings are in capitals, the 0 will be replaced with a space. Example......: dd-mm-yy Type.........: Input date format Description..: Specifies the way SuperBBS uses the date in it's input fields. Please note the difference with the previous option. This one is only for input fields. You can't use the dd-mmm-yy for- mat in this field. Note that when you change this field, you should also change the string asking for the birthday and any other date, like new files check. Example......: mm-dd-yy Type.........: Time format Description..: Specifies the way SuperBBS uses it time format. Here's an example: hh:mm te becomes: 03:03 pm hh:mm 15:03 If characters are in capitals, the 0 will be replaced by a space. Example......: hh:mm -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 067 3.2.2 Logon strings (Page 1) -------------------------------------------------------------- These are strings shown to the user when entering the system. Type.........: ANSI logon question Description..: Asked at the moment SuperBBS detects a carrier. Only works when the option in the main con- figuration program is activated. Example......: Display ANSI login Type.........: Name question Description..: Shown to user when SuperBBS asks for the users name at logon. Example......: Enter your first and last name : Type.........: Name entered string Description..: Shown to the user if his/her name was not found in the userlist and SuperBBS asks if the name is correct. Example......: Name entered : Type.........: Correct question Description..: Shown when SuperBBS asks if the name is cor- rectly written. Example......: Is this correct Type.........: Alias question Description..: Shown when SuperBBS asks for an alias. Example......: Choose your alias to use : Type.........: Use alias question Description..: Shown to the user when he/she pressed [Enter] at the alias question. Example......: Do you want to use an alias Type.........: City question Description..: Shown to the new user when SuperBBS asks for the city and state the user is from. Example......: Where are you calling from (City & State) ? Type.........: ANSI question Description..: Shown to the new user when SuperBBS asks the user if he/she wants ANSI graphics. Example......: Would you like ANSI colour graphics Type.........: Mailcheck question Description..: Shown to the new user when SuperBBS asks if the user wants a mail check at every logon. Example......: Would you like a mailcheck at every logon -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 068 Type.........: Newfiles question Description..: Shown to new users when SuperBBS asks if the user wants a new files check at every logon. Example......: Would you like a new files check at every logon Type.........: Editor question Description..: Shown to the new user when SuperBBS asks if the user wants to use the fullscreen editor. This question is only asked if the user answered 'YES' to the ANSI question. Example......: Do you like to use the full-screen editor Type.........: Screen length question Description..: Shown to the new user when SuperBBS asks the user what screenlength he/she want. this defaults to 24 lines per page. Example......: How many lines per screen page (12 - 60) ? Type.........: Birthday question Description..: Shown to the new user when SuperBBS asks for the users birthday. Example......: Your birthday (DD.MM.YY) ? Type.........: More question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the 'More (Y/n)?' prompt or not. Example......: Would you like to pause after each page Type.........: Screen clears question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the screen to be cleared if the CLS code is send. Example......: Do you want the screen to be cleared Type.........: Home phone number Description..: Shown to the new user when SuperBBS asks the user for his/her voice telephone number. Example......: Please enter your VOICE phone number : Type.........: Data phone number Description..: Shown to the new user when SuperBBS asks the user for his/her data telephone number. Example......: Please enter your DATA phone number : Type.........: Scanning dupe # Description..: Shown to the user when SuperBBS is scanning the userbase for duplicate phonenumbers. Example......: Scanning for duplicate numbers. Please wait ... -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 069 3.2.3 Logon strings (Page 2) -------------------------------------------------------------- Type.........: New password question Description..: Shown to the user when SuperBBS asks the user for the password the user wants to use on the BBS. Example......: Enter the password to use : Type.........: Password check question Description..: Shown to the user when SuperBBS asks the user for the password to be re-entered. Example......: Re-enter your password : Type.........: All OK question Description..: Shown to the user when SuperBBS asks the user if he/she entered all questions correctly. Example......: Did you enter all information correctly Type.........: Password question Description..: Shown to the user when he/she has to enter the password to gain access to the BBS. Example......: Password : Type.........: Mail check message 1 Description..: Shown to the user when SuperBBS is scanning for mail for the user. Example......: Checking for new mail addressed to you.... Type.........: Mail check message 2 Description..: Show to the user when no messages are found for the user. Example......: Sorry, no new messages found Type.........: Mail check message 3 Description..: Shown to the user when messages are found for the user. Example......: Read messages now Type.........: Password failure message Description..: Shown to the user when he/she entered a wrong password for three times and SuperBBS asks if he/she wants to leave a message. Example......: Do you want to leave a message for the Sysop Type.........: Full screen reader Description..: Shown to the new user when SuperBBS asks the user if he/she wants to use the full-screen reader. Example......: Do you want to use the full screen reader -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 070 Type.........: Sex question Description..: Shown to the user when SuperBBS asks if the user is a male or female. Example......: Your sex <F>emale or <M>ale ? Type.........: Female character Description..: Character used in the Sex question for the Female. Example......: F Type.........: Male character Description..: Character used in the Sex question for the Male. Example......: M Type.........: Combined mail check question Description..: Shown to the user when he/she is asked if he/she wants to check mail in the whole data- base or just on the (selected) combined areas. This question is shown to new users, if enabled by the Sysop. Example......: Would you like to use the combined areas only in the mailcheck Type.........: Hotkeys question Description..: Shown to the user when he/she is asked if hotkeys should be used or not. Example......: Would you like to use hotkeys 3.2.4 Message base strings (Page 1) -------------------------------------------------------------- Strings used in the message base part of the SuperBBS program. Type.........: Board information string 1 Description..: String shown to user when reading or viewing messages. This string gives information about the active messages and the area name. The control codes Ctrl-KC (= active messages) and Ctrl-K5 (= name message board) can be used. Example......: Active message board: ^KC (^K5 act. messages) Type.........: Board information string 2 Description..: Shown to the user when reading or viewing mess- ages. This string gives information about the message numbers in the area. The control codes Ctrl-KD (= lowest message number) and Ctrl-KE (= highest message number) can be used. You will have to use a different line here if you have set the real message numbering system of SuperBBS to on. You have to tell the user (Continued on next page) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 071 how many messages there are in the area, instead of on the system. In that case you can use %1 for the lowest message number and %2 for the highest message number. Example......: System has messages numbered ^KD to ^KE. Area has messages numbered %1 to %2. Type.........: Pause question Description..: Shown to the user when SuperBBS asks the user if he/she wants to pause after each message. Example......: Pause after each message Type.........: Delete confirmation Description..: Shown to the user when SuperBBS asks the user if he/she really wants to delete the message. Example......: Are you sure Type.........: End of replies Description..: Shown to the user when there are no more replies to be read. Example......: End of replies Type.........: End of messages Description..: Shown to the user when there are no more mess- ages to be read in the area. Example......: End of messages Type.........: Private question Description..: Shown to the user when SuperBBS asks him/her if the message is private or not. Example......: Private message Type.........: Use of alias question Description..: Shown to the user when SuperBBS asks the user if he/she wants to use his/her alias to write the question. Example......: Do you want to use an alias Type.........: Message abort string Description..: Shown to the user when the message is aborted. Example......: Message aborted ... Type.........: Jump number question Description..: Shown to the user when SuperBBS asks the user to which question he/she wants to jump. Example......: Enter message number to jump to : Type.........: Invalid number string Description..: Shown to the user when he/she entered a message number which did not exist. Example......: Invalid message number -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 072 Type.........: Choose area string Description..: Shown to the user when SuperBBS asks the user to choose a message area. Example......: Choose message area : Type.........: Message to ALL string Description..: Shown to the user when he/she needs to enter the name for whom the message is for telling what to type if the message is to all. Example......: Enter 'ALL' if message is to everyone Type.........: Who to question Description..: Shown to the user when SuperBBS wants to know who the message is for. Example......: Who is the message to : Type.........: Subject question Description..: Shown to the user when SuperBBS wants to know what the subject of the message is. Example......: Subject: Type.........: Alias in message question Description..: Shown to user when he/she wants to use an alias in the message, but is not using one. Example......: Choose alias to use: Type.........: Start number question Description..: Shown to the user when he/she has to enter the number of the message where SuperBBS has to start displaying. Example......: Enter number to start : Type.........: Name not found Description..: Shown to the user when the user entered a name which is not in the userfile. Example......: Name not in userfile 3.2.5 Message base strings (Page 2) -------------------------------------------------------------- Type.........: New messages Description..: Shown to the user when he/she searches for unread mail in the mail areas. Example......: Following areas have unread mail : Type.........: No new messages Description..: Shown to the user when there are no new mess- ages at an unread message scan. Example......: No unread messages found in any area ... -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 073 Type.........: How many latest Description..: Shown to the user when he/she wants to read messages and SuperBBS asks how many the user wants to read. Example......: How many messages do you want to read ? Type.........: New string Description..: Shown to the user when there are unread mess- ages found at the mail scan of unread mail. The %1 string is replaced with the number of mess- ages. Example......: %1 new messages Type.........: To you Description..: Shown to the user when there are personal unread messages found during the mail scan for unread mail. The %1 is replaced by the number of messages. This string is shown behind the previous string. If there are no personal mess- ages, this string is not shown. Example......: , %1 to you Type.........: Private string Description..: Shown to the user when a message is private. This string is shown in the header of the mess- age. Example......: private Type.........: Public string Description..: Same as previous string, except for public messages. Example......: public Type.........: Received string 1 Description..: Shown in the header of a message when the mess- age is received. Example......: Received Type.........: Received string 2 Description..: Shown in the header of a message when the mess- age is received. This string is followed by the date of the message it was received on. Example......: Received on Type.........: Kill/sent Description..: Shown in the header of a netmail message if this message has the kill/sent flag set. Example......: Kill/sent Type.........: Crash Description..: Shown in the header of a netmail message if this message has the crash flag set. Example......: Crash -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 074 Type.........: Files Description..: Shown in the header of a netmail message if the file attach flag has been set for the message. Example......: Files Type.........: Sent Description..: Shown in the header of a netmail message if the message has the sent flag set. Example......: Sent Type.........: Date field Description..: Shown in the header of the message to the user in front of the date of the message. Example......: Date : Type.........: From field Description..: Shown in the header of the message to the user in front of the name of the writer of the mess- age. Example......: From : Type.........: To field Description..: Shown to the user in front of the name of the receiver of the message. Example......: To : Type.........: Subject field Description..: Shown in the header of a message to the user indicating the subject of the message. Example......: Subj : Type.........: 1st line Description..: Shown in the header of the message, stating the message number and time and date of the writing of the message. Three control codes are used here: %1 Message number %2 Date of the message %3 Time of the message This is an indication of how old a message is. Example......: Message #%1 on "%2" %3 3.2.6 Message base strings (Page 3) -------------------------------------------------------------- Type.........: No write security Description..: Shown to the user when he/she has no rights, set in the messagebase part of the configur- ation, for writing in the area. Example......: You don't have write access -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 075 Type.........: No read security Description..: Shown to the user when he/she has no rights, set in the messagebase part of the configur- ation, for reading in the area. Example......: You don't have read access Type.........: No new messages Description..: Shown to the user when there are no new mess- ages in an area, while in area by area read. The control code %1 is replaced by the area number. Example......: No new messages in area %1. Type.........: Jumping to area Description..: Shown to the user when SuperBBS jumps to the next area, while in area by area read. Example......: Jumping to the next message area... Type.........: Choose message area Description..: String shown to the user when he/she is chang- ing message area with menu type 68 and you have enabled the 'quick' change option, in which case the user will only get this string. Press- ing enter will display the message area list. Example......: Choose area (ENTER = Area list): Type.........: No replies Description..: Shown to the user when it is not allowed to reply in the current message area. Example......: Replies not allowed in this area. 3.2.7 Message reading command keys -------------------------------------------------------------- The following strings are used while reading messages on the system. They are the commands shown to the user at the end of a message. It is now possible to define these strings as you like. To tell SuperBBS which character is the command charac- ter, i.e. the key to activate the command, use the @ sign. The character behind this sign will be placed between brackets, to tell the user what the activate key is. Here's an example: ne@Xt message will be displayed as: ne<X>t message Take care you are not using the same character twice or more as an activate key! It is advised to keep the activate charac- ter the same as in the normal english commands, like R for reply and D for delete, although you could change the command word. Please note this is an advise, your free to do other- wise. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 076 Type.........: Next reply Description..: Command for reading the next message in the reply chain. Only shown when there is a reply chain. Example......: @+ Next reply Type.........: Previous reply Description..: Command for reading the previous message in the reply chain. Only shown when there is a reply chain. Example......: @- Previous reply Type.........: Quit reading replies Description..: Command to quit the reading of replies. Example......: @Quit reading replies Type.........: Again string Description..: Command to show the message again. Example......: @Again Type.........: Next string Description..: Command for next message. Example......: @Next Type.........: Back string Description..: Command to show previous message. Example......: @Back Type.........: Jump string Description..: Command to jump to a certain message number. Example......: @Jump Type.........: Reply string Description..: Command for replying to the just read message. Example......: @Reply Type.........: Write string Description..: Command for writing a new message in the cur- rent area. Example......: @Write Type.........: Delete string Description..: Command for deleting the just read message. Example......: @Delete Type.........: Keep string Description..: Command to keep a message unread. Example......: @Keep unread Type.........: Copy string Description..: Command for copying a message. Example......: @Copy -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 077 Type.........: Export string Description..: Command for exporting a message (to a printer or file). Example......: @Xport Type.........: Edit string Description..: Command for editing the current message. Example......: @Edit Type.........: Toggle private string Description..: Command to make a message private if public or public if private. Example......: @= Pvt/Public Type.........: Update user string Description..: Command for updating a user. Example......: @Update Type.........: Stop string Description..: Command to stop reading messages. Example......: @Stop Type.........: Next area string Description..: Command to go to the next area while in area by area read. Example......: @Goto next area Please note that only those commands are shown to the User/Sysop which he/she has access to. 3.2.8 File area strings (Page 1) -------------------------------------------------------------- Strings shown to the user when he/she is in the file base part of the bulletin board. Type.........: File mask question Description..: Shown to the user just before SuperBBS displays the Files.bbs list. Here the user can enter a search pattern to look for. Example......: Enter filemask (ENTER = ALL) : Type.........: Batch download question Description..: Shown to the user when SuperBBS asks the user what he/she wants to download. Example......: Enter files to download (Wildcards valid) : Type.........: Filename question Description..: Shown to the user when SuperBBS wants to know the filename. Example......: Enter filename : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 078 Type.........: String search question Description..: Shown to the user when SuperBBS wants to know what string to look for. Example......: Enter string to look for in listings : Type.........: Name search question Description..: Shown to the user when SuperBBS wants to know what filename to look for. Example......: Enter filename to search for (Wildcards valid): Type.........: New file search question Description..: Shown to the user when SuperBBS asks the user the date to search from when scanning for new files. Example......: Enter date to search from (mm/dd/yy) ? Type.........: Area change question Description..: Shown to the user when he/she wants to change from a file area to another. Example......: Choose file area : Type.........: Pack files question Description..: Shown to the user when SuperBBS asks the user which files need to be packed from the 'temp' directory option. Example......: Enter file names to pack (ENTER = STOP): Type.........: Delete files question Description..: Shown to the user when SuperBBS asks the user which files need to be deleted from the temp directory. Example......: Enter files to delete : Type.........: Not found string Description..: Shown to the user when a file is not found. Example......: File not found !! Type.........: No upload string Description..: Shown to the user when uploads are not allowed in the file area. Example......: No uploads allowed to this area Type.........: No download string Example......: Shown to the user when downloads are not allowed in the file area. Example......: No downloads allowed from this area Type.........: Files to upload question Description..: Shown to the user when SuperBBS asks the user what he/she wants to upload. Example......: Enter filenames to upload (ENTER = STOP) : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 079 Type.........: Before transfer question Description..: Shown to the user before the transfer is started. the user can press 'ENTER', which will start the transfer, press '!' to logoff after the transfer or press 'A' to abort. Example......: [ENTER] = start, [!] = logoff, [A] = abort Type.........: Start transfer Description..: Shown to the user when SuperBBS starts the transfer. Ctrl-X can interrupt the transfer. Example......: Start transfer. Press Ctrl-X to interrupt Type.........: File exist Description..: Shown to the user when a file already exist in the file base. %1 will be replaced by the filename. Example......: File %1 is already here ! Type.........: Virus in file Description..: Shown to the user when a virus is detected in the uploaded file. %1 will be replaced by the filename. Example......: File %1 contains a virus ! Type.........: Not received Description..: Shown to the user when a file was expected, but not received. %1 will be replaced by the filename. Example......: File %1 was expected but not received ! 3.2.9 File area strings (Page 2) -------------------------------------------------------------- Type.........: Please describe Description..: Shown to the user when he/she has to describe the file uploaded to the BBS. This is the first information string shown. Example......: Please enter a description for your upload : Type.........: "/" = private file Description..: Shown to the user telling him/her that a '/' in front of the description will make the file private to the Sysop. Example......: (Begin description with '/' if Sysop file) Type.........: Please describe 1 Description..: Shown to the user when the user has to enter the first line of the file description. %1 will be replaced by the filename. Example......: Please describe %1 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 080 Type.........: Please describe 2 Description..: Shown to the user when he/she needs to enter the second to fifth line of the description. Example......: Press Enter to stop Type.........: Description to short Description..: Shown to the user when he/she has entered a to short file description. Example......: Description must be at least 4 characters Type.........: File is unwanted Description..: Shown to the user if he/she is planning to send a file which the Sysop doesn't want. (See the FILES.CTL part in the control file section of the docs.) %1 will be replaced by the filename. Example......: The file %1 is not wanted ! Type.........: Files received Description..: Shown to the user when the files are received. %1 will be replaced by the number of files received. Example......: %1 files received. Type.........: Files sent Description..: Shown to the user when the files have been sent. %1 will be replaced by the number of files. Example......: %1 files sent. Type.........: No files found Description..: Shown to the user when SuperBBS can't find any files to send. Example......: No files found Type.........: Not enough time Description..: Shown to the user when he/she doesn't have enough time to download the file. Example......: You don't have enough time left Type.........: Password question 1 Description..: Shown to the user when he/she tries to download a file which is password protected. (See the FILES.CTL part of the documentation.) %1 is replaced by the filename. Example......: The file %1 is password protected ! Type.........: Password question 2 Description..: Shown to the user when he/she has to enter the password for the file. Example......: Enter password : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 081 Type.........: Select area string Description..: Shown to the user at the top of the screen if he/she is using the pick area change command. Example......: Select file area with cursor keys: Type.........: Select area info Description..: Shown at the bottom of the area pick screen, telling the user what to do when changing file areas. Example......: [ENTER]...Choice [A]...Choose area by number Type.........: Virus check question Description..: Shown to the user when he/she wants to check a file for viruses. Example......: Enter files to be checked : Type.........: File offline string Description..: Shown to the user in the Files.bbs listing if the file is in the files.bbs list, but not in the directory. You can only use a limited num- ber of characters here. Example......: Offline Type.........: Files tagged string Description..: Textstring shown to the user after he/she flagged a file for download. This informs the user about the number of files flagged and the amount of Kbytes. The following control codes can be used here: %1 Number of files flagged %2 Amount of bytes Example......: %1 files flagged, the size is %2 bytes. Type.........: Tag download limit exceeded Description..: Shown to the user when he/she wants to flag a file, but this would exceed the time/size down- load limit. Example......: Your download limit would be exceeded. Type.........: No wild cards Description..: Shown to the user when he/she uses a wildcard character when flagging files. Only full filenames are allowed at file flagging. Example......: Wildcards not allowed. Type.........: File to flag question Description..: Text shown to the user when he/she selects the file flag option during the (new)files list. Example......: Enter filename to flag : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 082 3.2.10 Filearea string configuration (Page 3) -------------------------------------------------------------- Type.........: Download flagged Description..: Shown to the user when he/she selects the down- load command and there are files flagged for download. Example......: Download the flagged files Type.........: Files to remove Description..: Shown to the user when he/she selects to remove a file from the list with flagged files. Example......: Enter filenumber to remove (ENTER = Stop) : 3.2.11 Other strings (page 1) -------------------------------------------------------------- Strings which can be found all over SuperBBS are defined here. Type.........: Press Enter string Description..: Shown to the user when he/she has to press ENTER to continue. Example......: Press [ENTER] to continue ... Type.........: Press S or P string Description..: Shown to the user when he/she can press S or P to stop or pause a listing. Example......: Press S to Stop or P to Pause listing Type.........: Please wait string Description..: Shown to the user when he/she has to wait, because SuperBBS is working. Example......: Please wait a moment ... Type.........: Yes character Description..: Character used in SuperBBS to represent the 'Yes' character. Example......: Y Type.........: No character Description..: Character used in SuperBBS to represent the 'No' character. Example......: N Type.........: Chat reason question Description..: Shown to the user when SuperBBS asks the user for the reason to chat. Example......: Reason for chat : Type.........: Chat start string 1 Description..: Shown to the user when the Sysop entered the chat with the user. this is the first line. Example......: Sysop chat mode entered ... -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 083 Type.........: Chat start string 2 Description..: Second string shown to the user when the Sysop entered chat mode. Ctrl-FW can be used to dis- play the user's first name. Example......: Hello ^FW, this is your Sysop. Type.........: Chat info string Description..: Shown at the bottom of the full-screen chat screen. Example......: [^R] Redraw screen [^W] to clear your screen Type.........: Chat end string Description..: Shown to users when the chat is over. Example......: Sysop chat mode ended ... Type.........: Dos shell string 1 Description..: Shown to the user when the Sysop jumps to Dos level with Alt-J. Example......: Sysop has shelled to Dos, please wait ... Type.........: Dos shell string 2 Description..: Shown to the user when the Sysop returned from the jump to Dos. Example......: Sysop has returned from Dos. Thanks for waiting Type.........: Update string 1 Description..: Shown to the user when the Sysop is updating the user information. Example......: Sysop is updating you information ... Type.........: Update string 2 Description..: Shown to the user when the Sysop finished up- dating the user information. Example......: Sysop has done it ... The following strings are used when the user asks for the time statistics. (See menu options). Type.........: Current time string Description..: Shown when SuperBBS shows the user the time. The %1 will be replaced by the current time. Example......: Current time : %1 Type.........: Current date string Description..: Shown to the user when SuperBBS tells the user the date. The %1 will be replaced by the date. Example......: Current date : %1 Type.........: Connect time string Description..: Shown to the user when SuperBBS displays the time the user can be connected. The %1 will be replaced by the minutes, the %2 by the seconds. Example......: Connect time : %1 min %2 sec. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 084 Type.........: Time used string Description..: Shown when SuperBBS tells the user how much time he/she has been online. Example......: Time used : %1 min %2 sec. Type.........: Time left string Description..: Shown to tell the user how much time he/she has left over this call. Example......: Time left : %1 min. Type.........: Call limit string Description..: Shown to the user to tell the call limit. Example......: Call limit : %1 min. Type.........: Time in bank Description..: Shown to the user to tell the amount of time the user has in the timebank. Example......: Time in bank : %1 min. 3.2.12 Other strings (Page 2) -------------------------------------------------------------- Type.........: Bad phone number string Description..: Shown to the user when he/she entered a wrong telephone number. Example......: You have to enter a full telephone number ! Type.........: Password not changed Description..: Shown to the user when his/her password is not changed. Example......: Password not changed. Type.........: Ask current password Description..: Shown to the user when he/she wants to change the password and has to enter the current pass- word. Example......: Please enter your CURRENT password : Type.........: Current alias string Description..: Shown to the user when SuperBBS displays the user's current alias. Example......: your current alias is : Type.........: Combined string 1 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This strings tells the user what to do. Example......: Enter board numbers to toggle on/off -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 085 Type.........: Combined string 2 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This string tells the user the commands to use at the toggle menu. Example......: ON=All On OFF=All Off T=Toggle D=Default Type.........: Search user question Description..: Shown to the user when the user wants to search the userlist and SuperBBS asks for part of the name. Example......: Enter part of username to search for : Type.........: Search alias question Description..: Shown to the user when the user wants to search the alias userlist and SuperBBS asks for part of the alias name. Example......: Enter part of alias or username to search for : Type.........: More question Description..: Shown to the user when the maximum screenlength is reached and the user as to state if he/she wants to continue or not. Three options are available here, Yes, No or continues. Example......: More (Y,N,C) ? Type.........: More question 2 Description..: Shown to the user when the maximum screenlength is reached while viewing the (new)files list and the user has to state if he wants to con- tinue or not. As of version 1.16, there is also the option to flag a file for download and to view the contents of an archived file (see the chapter on the filebase for more info). An option to view the list continues till the end is also available. Example......: More (Y,N,C), <A>rchive view or <F>lag file ? Type.........: More Yes character Description..: Character used in the More? question as the Yes character. Example......: Y Type.........: More No character Description..: Character used in the More? question as the No character. Example......: N Type.........: More continues character Description..: Character used in the More? question as the continues character. Example......: C -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 086 Type.........: More flag character Description..: Character used in the More? question as the fileflag character. Example......: F Type.........: More view archive character Description..: Character used in the More? question as the view archive character. Example......: A Type.........: 20 sec to inactivity Description..: Shown to the user 20 seconds before SuperBBS disconnects, if the user is inactive. Example......: * Warning : Only 20 seconds to hangup ! Type.........: Inactivity string Description..: Shown to the user at the moment SuperBBS dis- connects, because the user was inactive. Example......: User inactive, hanging up ... Type.........: Two minutes warning Description..: Shown to the user by SuperBBS when he/she has only 2 minutes left. Example......: * Warning : Only 2 minutes time left ! Type.........: Time exceeded string Description..: Shown to the user when SuperBBS disconnects because the user's time limit is exceeded. Example......: Time limit exceeded. Call back tomorrow ... Type.........: Yes string Description..: String used within SuperBBS for the Yes string. Example......: Yes Type.........: No string Description..: String used within SuperBBS for the No string. Example......: No Type.........: Alias list top string Description..: String shown at the top of the alias list. This tells the user which row the alias is and which row the real name. Please note the location carefully. Example......: Name Alias 3.2.13 Other strings (Page 3) -------------------------------------------------------------- Type.........: Alias in use string Description..: Shown to the user if he/she selected an alias which is already in use. Example......: That's already in use, choose again ! -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 087 Type.........: Invalid screen length Description..: Shown to the user when the user selected a wrong screen length. (Not between 12 and 60 lines.) Example......: Invalid screenlength entered ! Type.........: Password short string Description..: Shown to the user if a password is entered which is to short. (Min. 4 characters.) Example......: Password is to short. Try again ! Type.........: Password check failed Description..: Shown to the user when he/she entered his/her old password and it didn't match the real pass- word when changing passwords. Example......: Passwords do not match. Type.........: Password changed string Description..: Shown to the user when the password change was successful. Example......: Password changed successfully Type.........: Wrong string Description..: Shown to the user when entering a wrong pass- word. Example......: Wrong !! Type.........: Ask line number string Description..: Shown to the user when he/she has to enter a line number. Example......: Enter line number : Type.........: Minutes in bank Description..: Shown to the user when SuperBBS shows the amount of minutes the user has deposit in the timebank. Ctrl-K7 can be used to display the amount in minutes. Example......: You have ^K7 minutes in the bank Type.........: Time left string Description..: Shown to the user stating how much time the user has left. Ctrl-KO can be used to display the amount of time left. Example......: You have ^KO minutes left Type.........: Deposit ? Description..: Shown to the user when he/she wants to deposit time in the bank. Example......: How much time do you want to deposit ? -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 088 Type.........: Withdraw ? Description..: Shown to the user when he/she wants to withdraw time from the bank. Example......: How much time do you want to withdraw ? Type.........: You can deposit Description..: Shown to the user when SuperBBS tells the user how much time he/she can deposit. %1 is replaced by the maximum number of minutes the user can deposit. Example......: You can deposit %1 minutes. Type.........: Next user comment Description..: Shown to the user when he/she wants to enter a comment for the next user. Example......: Enter your comment for next user .... Type.........: Save comment ? Description..: Shown when the user needs to save the comment. Example......: Save comment Type.........: Message after page Description..: Shown to the user after an unsuccessful page attempt and before the user can enter a message to the Sysop. Example......: Would you like to leave a message Type.........: Usage graph top Description..: Shown to the user as the top line of the graphical usage display of the system. The following control codes can be used: %1 Start date of usage graph %2 Current date %3 Number of days between %1 and %2 This line is shown as the first line on the screen. The information is taken from one of the SuperBBS control files, TIMELOG.BBS. Example......: System usage graph for %1 to %2 (%3 days) Type.........: Option not available Description..: Shown to the user when a menu option is not available due to opening hours of the menu function. (See menu functions 1, 2 and 4 for more information on this subject.) Two control codes are available: %1 Opening time menu option %2 Closing time menu option (Continued on next page) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 089 These time settings are all done in the optional data field of the menu option. Example......: Option is only available between %1 and %2. Type.........: Choose door string Description..: Shown to the user when selecting a door from the selection menu when using door templating. Example......: Choose door to run : Type.........: You're too young Description..: Shown to the user when he/she wants to enter a menu option which has a minimum age set and his/her age is not high enough. Example......: You're too young to enter this menu! 3.2.14 Other string (Page 4) -------------------------------------------------------------- Type.........: Agegraph top string Description..: Shown to the user at the top of the age graph. Two control codes can be used here: %1 Number of users %2 Average age Note that you can set the starting age in the configuration program. Example......: System Age Graph (%1 users, average age %2) 3.2.15 Status string configuration -------------------------------------------------------------- These strings are shown when the user toggles some setting on or off and when SuperBBS displays the settings. Type.........: "On" string Description..: The string to represent the word 'ON'. Example......: ON Type.........: "Off" string Description..: The string to represent the word 'OFF'. Example......: OFF Type.........: Screen clear status Description..: String to tell the user the status of the screen clear command. The %1 will be replaced by the ON or OFF string. (See above). Example......: Screen clears are now %1 Type.........: More status Description..: String to tell the status of the more prompt. Example......: More prompts are now %1 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 090 Type.........: Ansi status Description..: String to tell the status of ANSI graphics. Example......: Ansi graphics are now %1 Type.........: Ansi editor status Description..: String to tell the status of the full screen ANSI editor. Example......: Full screen ANSI editor is now %1 Type.........: Mail check status Description..: String to tell the status of the mail check at logon. Example......: Mail check at logon is now %1 Type.........: New files status Description..: String to tell the status of the new files check at logon. Example......: New files check at logon is now %1 Type.........: Disturb mode status Description..: String to tell the status of the 'Do not disturb' flag. Example......: Do not disturb mode is now %1 Type.........: Full screen viewer status Description..: String to tell the status of the full screen message viewer. Example......: Full screen message viewer is now %1 The following strings are used in conjunction with the Sysop availability option in SuperBBS. (Num-lock On/Off). Type.........: Available string Description..: String to represent the word 'Available'. Example......: Available Type.........: Unavailable string Description..: String to represent the word 'Unavailable'. Example......: Unavailable Type.........: Combined mail check Description..: Shown to the user when he/she turns the new mail check on or off for the combined mail areas. One control code is used: %1 Status of combined mailcheck The %1 will be translated with ON or OFF. Example......: Combined mail area check is %1 -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 091 Type.........: Hotkey status Description..: Shown to the user when he/she switches the hotkeys on or off. One control code is used here, which is translated into ON or OFF: %1 Status of hotkeys Example......: Hotkeys are now %1 3.2.16 Month names -------------------------------------------------------------- Here you can define the abbreviations for the twelve month. These will be used if SuperBBS has to display the month. Don't use more than 3 characters for the abbreviations. You can also use the numerical code for the month, i.e. Jan = 01, Feb = 02, Mar = 03 etc. 3.2.17 Weekday names -------------------------------------------------------------- Here you can define the weekday names. Both a long and short version is used. The long version is the full name, the short version is the abbreviation. 3.2.18 BBS List strings -------------------------------------------------------------- These strings are used when using the BBS list options build into SuperBBS. Except for one string, they are all used to display the BBS information in the list. Type.........: BBS name string Description..: Shown in front of the BBS name. Example......: Name : Type.........: BBS phone string Description..: Shown in front of the phone number. Example......: Phone : Type.........: BBS max. speed Description..: Shown in front of the modem speed. Example......: Max speed : Type.........: BBS open string Description..: Shown in front of the opening hours. Example......: Open hours : Type.........: BBS software string Description..: Shown in front of the BBS software. Example......: Software : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 092 Type.........: BBS address string Description..: Shown in front of the node number. Example......: Node number : Type.........: BBS sysop string Description..: Shown in front of the Sysop name. Example......: Sysop : Type.........: BBS other string Description..: Shown in front of the other information. Example......: Other : Type.........: BBS to delete string Description..: Shown to the Sysop who wants to delete his/her BBS from the BBS list. Example......: Enter BBS to delete from list : 3.2.19 Multi line status strings -------------------------------------------------------------- These strings are shown to the user when he/she asks for the status of the available lines. Type.........: Status string #1 Description..: Shown to the user when the user(s) on the other line(s) is(/are) doing nothing special, like staring at a menu screen. Example......: Doing nothing special Type.........: Status string #2 Description..: Shown to the user when the user(s) on the other line(s) is(/are) downloading. Example......: Downloading Type.........: Status string #3 Description..: Shown to the user when the user(s) on the other line(s) is(/are) uploading. Example......: Uploading Type.........: Status string #4 Description..: Shown to the user when the user(s) on the other line(s) is(/are) reading messages. Example......: Reading messages Type.........: Status string #5 Description..: Shown to the user when the user(s) on the other line(s) is(/are) writing messages. Example......: Writing messages Type.........: Status string #6 Description..: Shown to the user when the user(s) on the other line(s) is(/are) chatting with the Sysop. Example......: Chatting with Sysop -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 093 Type.........: Status string #7 Description..: Shown to the user when the user(s) on the other line(s) is(/are) using an external program. Example......: Using external program Type.........: Status string #8 Description..: Shown to the user when the user(s) on the other line(s) is(/are) logging on. Example......: Logging on Type.........: Status string #9 Description..: Shown to the user when the system is waiting for another caller or event. Example......: Waiting for a call or event Type.........: Status string #10 Description..: Shown to the user when the line is down. Example......: Down Type.........: Status string #11 Description..: Shown to the user when the user(s) on the other line(s) is(/are) using the QWK system. Example......: Using QWK system Type.........: Status string #12 Description..: Shown to the user when the user(s) on the other line(s) is(/are) browsing the file list Example......: Browsing the file list Type.........: Status string #13 Description..: Shown to the user when the user(s) on the other line(s) is(/are) in node chat. Example......: In node chat 3.2.20 QWK strings -------------------------------------------------------------- These string are shown when using the QWK offline reader build in to SuperBBS. Support this system and make the options available to your users. Type.........: Reply not found Description..: Shown to the user when the file with replies is not found. These files have the .REP extension. Control code %1 can be used for the filename. Example......: %1 not found ... Type.........: QWK format question Description..: Shown to the user when SuperBBS asks the user if he/she wants to download the messages in QWK format or in ASCII format. Example......: Download the packet in .QWK format -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 094 Type.........: Limits is # messages Description..: Shown to the user when he/she wants to download more messages than the limit is set to. Control code %1 is used to display the message limit. Example......: Sorry, the limit is %1 messages Type.........: Messages exported Description..: Shown to the user when SuperBBS is about to pack the messages. The control code %1 is used to display the amount of messages exported from the messagebase. Example......: %1 messages exported Type.........: Packing messages Description..: Shown to the user when SuperBBS is packing the messages after they were exported from the messagebase. Example......: Packing messages. Please wait .... Type.........: No new messages Description..: Shown to the user when there are no new mess- ages in the message areas selected. Example......: Sorry, no new messages found ... Type.........: Message moved Description..: Shown to the user when his/her message(s) is(/are) moved to the default message area for some reason. Example......: Message has been moved to the default area Type.........: Upload question Description..: Shown to the user when SuperBBS asks the user if he/she wants to upload a reply packet. The control code %1 is used to display the filename. Example......: Do you want to upload %1.REP Type.........: Max # messages to pack question Description..: Shown to the user when SuperBBS needs to know how many messages to pack for the user. Example......: Maximum number of messages to pack : Type.........: Update pointers question Description..: Shown to the user when SuperBBS asks him/her if the lastread pointer has to be updated. Example......: Update lastread pointer Type.........: Choose packer string Description..: Shown to the user when SuperBBS asks for the default archiver to use. Example......: Choose your default archiver : -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 095 3.2.21 A little help -------------------------------------------------------------- Just a little help screen with the most important options, so you have a quick reference guide incase you don't know a certain control code. 3.3 Control codes in strings -------------------------------------------------------------- SuperBBS allows the use of control codes in the strings which you define in Lconfig. These strings can be display different colours or it is even possible to display an ANSI/ASCII file. Colours are brought into the strings with the Ctrl-C and then the colour code. These are the colour numbers: 000. Black 001. Blue 002. Green 003. Cyan 004. Red 005. Purple 006. Brown 007. Grey 008. Dark grey 009. Light blue 010. Light green 011. Light cyan 012. Light red 013. Light purple 014. Yellow 015. White When you want to insert a control code in a string, you first have to press Ctrl-P to tell SuperBBS you are entering a control code. Here's an example: The file ^C014 %1 ^C003 is not wanted ! Enter the string first, then move to the place where you want to insert the colour code. Press Ctrl-P, Ctrl-C and 014. this will make the text behind it yellow. Repeat the sequence if you want another colour in a different spot. Always fill the colour code out to 3 characters. Example: Dark grey is: 008 (and not 8) Yellow is: 014 (and not 14) -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 096 If you want to make the prompts appearing after a piece of text in the same colour as the last used colour, use this command: Ctrl-C !. This will return the colour of the last used text display. This could be used to set the 'More Y/N prompt in the same colour as the displayed text before it. All control codes, as described later in this manual, can be used in the strings. Just press Ctrl-P first, before entering the code. Another powerful option is the possibility of displaying an ANSI/ASCII file instead of the string. This can be achieved through the use of the Ctrl-A code and the filename to dis- play. Here's an example for the string used for the not wanted files: <Ctrl-A>UNWANTED This will display the ANSI/ASCII file UNWANTED when a file is not wanted. The file has to be in the text directory specified in the configuration. Don't forget to press Ctrl-P before entering the Ctrl-A code. 3.4 Language.ctl file -------------------------------------------------------------- You will need to make a file called LANGUAGE.CTL. This file is the control file for the languages available. This file is a plain ASCII file with the following format: <Language filename> <Language filename> <Language filename> This file has to be in every line directory with multiline systems. This way you could run an English system on one line and an English and Dutch on the other line. The first language will be the language SuperBBS starts in. This means that any string shown to the user before he/she entered his/her name is from this language file. Until a caller entered his/her name, SuperBBS doesn't know which language the user is using. When a new user calls to your BBS, some textfiles will be shown to him/her before SuperBBS will ask which language they want. These files are: - NOTFOUND.A?? - NEWUSER1.A?? See for more information about these files the textfile part of this documentation. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 097 3.5 Hints and tips -------------------------------------------------------------- If you have problems understanding what all the strings are for in the language configuration program, use the following method of making a language file: - Copy the supplied ENGLISH.LNG file to your own name. - Start Lconfig with the new .LNG name. - Edit the strings. You will know what the original looks like and you'll be able to see where the special characters are used. (Characters like : and ?) - Exit the program after you're ready. This way it is easy to write a new language file in any lan- guage you like. End of part 1 of this documentation. Please see part two for the rest of the information on SuperBBS. -------------------------------------------------------------- SuperBBS v1.16 - Part A Page 098